cnfGetMemberInfo

Returns stream and timeslot information for a conference member.

Prototype

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

Argument

Description

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; 

Refer to the Details section for a description of these fields.

size

Maximum size of the buffer pointed by memberinfo.


Return values

Return value

Description

SUCCESS

 

CTAERR_BAD_ARGUMENT

memberinfo pointer is NULL.

CTAERR_BAD_SIZE

size is smaller than the size of CNF_MEMBER_INFO.

CTAERR_INVALID_HANDLE

cnfresourcehd is not a valid conference resource handle.

CNFERR_BOARD_TIMEOUT

The board timed out while waiting for a response message.

CNFERR_INVALID_IDENTIFIER

memberid is not a valid member identifier.


Details

cnfGetMemberInfo returns the information structure corresponding to the member designated by memberid.

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.

user_value

Application prompted value.


For more information, refer to Setting member 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);
}