Member Object

INmMember::Eject

HRESULT Eject(void);

Removes a member from the conference. Only the top provider can remove a member from the conference.

Returns S_OK if the request to eject the member succeeded, or E_FAIL if:
- The member is not in an active conference.
- The member is not in the conference.
- The local user is not the top provider.
- The member to be removed is the local user.

INmMember::GetAddr

HRESULT GetAddr(
    [out] BSTR *pbstrAddr,
    [out] NM_ADDR_TYPE *puType);

Retrieves the address for the member, if available.

Returns one of the following values:

S_OK Success.
E_POINTER The pbstrAddr pointer is invalid.
E_FAIL Internal resources are not available.

pbstrAddr

Pointer to a BSTR that contains the local user's name or address.

puType

Pointer to an NM_ADDR_TYPE that identifies the type of the user name/address. This can be one of the following:

NM_ADDR_H323_GATEWAY	IP address of the gateway server and the phone number (www.xxx.yyy.zzz/number). Also see INmManager::CreateCall.
NM_ADDR_IP	IP address.
NM_ADDR_MACHINENAME	Machine name.
NM_ADDR_ULS	ILS server name and e-mail name. (server/e-mail).
NM_ADDR_UNKNOWN	Unknown type.

The address and type returned by this method are the address and type that were used when the member joined the conference.

INmMember::GetConference

HRESULT GetConference(
    [out] INmConference **ppConference);

Retrieves a pointer to the conference in which the member is participating.

Returns one of the following values:

S_OK Success.
S_FALSE No conference is available.
E_POINTER The ppConference pointer is invalid.
E_FAIL Internal resources are not available.

ppConference: Pointer to a pointer to the INmConference Interface on the Conference object in which this member is participating.

If this method returns S_OK, the application must call Release for ppConference.

INmMember::GetID

HRESULT GetID(
    [out] ULONG *puID);

Retrieves the unique identifier for the Member object.

Returns S_OK if successful, or E_POINTER if the puID pointer is invalid.

puID: Pointer to a ULONG that contains the member identifier.

This method is only valid when there is a data conference.

INmMember::GetName

HRESULT GetName(
    [out] BSTR *pbstrName);

Retrieves the string for the member name.

Returns S_OK if successful, or E_POINTER if pbstrName is an invalid pointer.

pbstrName: Pointer to a BSTR that contains the user's name, if available.

INmMember::GetNmchCaps

HRESULT GetNmchCaps(
    [out] ULONG *puchCaps);

Retrieves information about the channels in which this member is currently participating.

Returns S_OK if successful, or E_POINTER if the puchCaps pointer is invalid.

puchCaps

Pointer to a ULONG that identifies the channel capabilities. Constants may include any of the following, or none, in which case NMCH_NULL is returned.

NMCH_AUDIO	Audio channel.
NMCH_DATA	Data channel.
NMCH_FT	File Transfer channel.
NMCH_SHARE	Application Sharing channel.
NMCH_VIDEO	Video channel.

INmMember::GetNmVersion

HRESULT GetNmVersion(
    [out] ULONG *puVersion);

Retrieves the NetMeeting version number.

Returns S_OK if successful, or E_POINTER if the puVersion pointer is invalid.

puVersion

Pointer to a ULONG containing the current version of NetMeeting. This can be one of the following:

NM_VER_1	= 1
NM_VER_2	= 2
NM_VER_FUTURE	= 15
NM_VER_UNKNOWN	= 0

The version number is valid only when the member has data capabilities.

INmMember::GetShareState

HRESULT GetShareState(
    [out] NM_SHARE_STATE *puState);

Retrieves the current application sharing tate for a member.

Returns S_OK if successful, or E_POINTER if the puState pointer is invalid.

puState

Pointer to an NM_SHARE_STATE that identifies the current application sharing state. This can be one of the following:

NM_SHARE_COLLABORATING	The local user is not working alone and does not have control of the cursor. Other conference members can work in any applications the local user has shared.
NM_SHARE_IN_CONTROL	Gives the local user control of the cursor. If the user was working alone, this will also grant permission to others to take control of this shared application.
NM_SHARE_UNKNOWN	The current state is unknown. This may result if this is an audio- and video-only conference, or if application sharing is not available.
NM_SHARE_WORKING_ALONE	The local user is working alone. Other conference members can see applications that this user has shared, but they cannot work in them. The local user can see applications that others have shared, but he or she cannot work in them.

INmMember::GetUserData

HRESULT GetUserData(
    [in] REFGUID rguid,
    [out] BYTE **ppb,
    [out] ULONG *pcb);

Retrieves the private data associated with the globally unique identifier (GUID) for the member.

This method is not yet implemented.

Returns one of the following values:

S_OK Success.
E_POINTER The ppb or pcb pointer is invalid.
E_INVALIDARG The rguid parameter is invalid.
E_FAIL Internal resources are not available.

rguid: GUID of the data to be retrieved.
ppb: Pointer to a pointer to the data
pcb: Pointer to a ULONG that contains the size of the data pointed to by ppb.

INmMember::IsMCU

HRESULT IsMCU(void);

Determines whether the Member object represents a multipoint control unit (MCU).

Returns S_OK if the Member object represents an MCU, or S_FALSE if it doesn't.

INmMember::IsSelf

HRESULT IsSelf(void);

Determines if the Member object represents the local user.

Returns S_OK if the Member object represents the local user, or S_FALSE if not.