Table of Contents Index NMS Glossary Previous Page Next Page (Page 7 of 23 in this chapter) Version


cnfGetConferenceInfo

Description

Returns an information structure about a conference.

Prototype

DWORD cnfGetConferenceInfo ( CNFRESOURCEHD cnfresourcehd,
DWORD confid,
CNF_CONFERENCE_INFO
*confinfo,
unsigned size)

cnfresourcehd Handle returned by cnfOpenResource.

confid Conference identifier returned by cnfCreateConference.

confinfo Pointer to a CNF_CONFERENCE_INFO structure:

typedef struct
{
DWORD size; /* size of the structure */
DWORD allocated_members; /* number of members allocated */
/* for this conference */
DWORD joined_members; /* number of members attending */
/* this conference */
DWORD flags; /* capabilities not used flags */
DWORD capabilities;
DWORD user_value;
} CNF_CONFERENCE_INFO;
See the Details section for a description of these fields.

size The size of the buffer pointed by confinfo.

Return Values

Details

This function returns the information structure corresponding to the conference designated by confid. The returned CNF_CONFERENCE_INFO size field contains the actual number of bytes written.

The CNF_CONFERENCE_INFO structure contains the following fields:
Field

Description

size

Number of bytes written to the buffer pointed to by confinfo.

allocated_members

Number of members allocated on the conferencing resource for this conference.

joined_members

Number of members currently joined in this conference.

flags

Capabilities disabled at conference creation time.

capabilities

Capabilities enabled at conference creation time.

user_value

Application prompted value.

For more information, see Section 4.7, Accessing Conference Information and Attributes.

See Also

cnfCreateConference, cnfGetConferenceList, cnfGetMemberInfo, cnfGetResourceInfo

Example

extern CNFRESOURCEHD cnfresourcehd;

INT32 getNumberOfMember(DWORD confid)
{
CNF_CONFERENCE_INFO confinfo; error = cnfGetConferenceInfo (cnfresourcehd, confid, &confinfo,
sizeof(CNF_CONFERENCE_INFO));
if (error != SUCCESS) { printf("Error when retrieving conference information :
%d",error);
} return(confinfo.joined_member); }


Table of Contents Index NMS Glossary Previous Page Next Page (Page 7 of 23 in this chapter) Version


Want to send us feedback on our documentation? Email: Tech_Pubs@nmss.com
Copyright © 2000, Natural MicroSystems, Inc. All rights reserved.