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


cnfGetMemberInfo

Description

Returns an information structure about a member.

Prototype

DWORD cnfGetMemberInfo ( CNFRESOURCEHD cnfresourcehd,
DWORD memberid,
CNF_MEMBER_INFO *memberinfo,
unsigned size)

cnfresourcehd Handle returned by cnfOpenResource.

memberid Member identifier returned by cnfJoinConference or cnfGetMemberList.

memberinfo Pointer to a CNF_MEMBER_INFO structure:

typedef struct
{
DWORD size; /* size of the structure */
DWORD stream; /* MVIP address */
DWORD timeslot; /* MVIP address */
DWORD user_value /* application provided value*/
} CNF_MEMBER_INFO;
See the Details section for a description of these fields.

size The maximum size of the buffer pointed by memberinfo.

Return Values

Details

This function returns the information structure corresponding to the member designated by memberid. The returned CNF_MEMBER_INFO size field contains the actual number of bytes written.

The CNF_MEMBER_INFO structure contains the following fields:
Field

Description

size

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

stream

The input MVIP-95 local stream (even value) to be used for connecting the member's line to the conference. To get the output stream, increment this stream by one.

timeslot

The MVIP timeslot to be used for connecting the member's line into the conference.

capabilities

Capabilities enabled at conference creation time.

user_value

Application prompted value.

For more information, refer to Section 4.8, Accessing Member Information and Attributes.

See Also

cnfJoinConference

Example

extern CNFRESOURCEHD cnfresourcehd;
DWORD getMemberMVIPAddr(DWORD memberid, DWORD *stream,
DWORD *timeslot)
{
CNF_MEMBER_INFO memberinfo; DWORD error; error = cnfGetMemberInfo (cnfresourcehd, memberid, &memberinfo,
sizeof(CNF_MEMBER_INFO));
*stream = memberinfo.stream; *timeslot = memberinfo.timeslot; return(error); }


Table of Contents Index NMS Glossary Previous Page Next Page (Page 11 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.