Share via

INmMember::GetUserData

  • Article

Use the GetUserData method to retrieve the private data associated with the globally unique identifier (GUID) for the member.

HRESULT GetUserData
  REFGUID rguid,  BYTE **ppb,  ULONG *pcb);

Parameters

  • rguid
    [in] GUID of the data to be retrieved.
  • ppb
    [out] Pointer to the location of the data.
  • pcb
    [out] Pointer to a location that contains the size in bytes of the data pointed to by ppb.

Return Values

NetMeeting client applications can use the SUCCEEDED and FAILED macros in winerror.h to check return values.

Return values can include RPC layer errors or any of the following values.

  • S_OK
    The user data of the member was retrieved successfully.
  • E_POINTER
    ppb or pcb is invalid.
  • E_INVALIDARG
    rguid is invalid.
  • E_FAIL
    Internal resources are not available.

Remarks

NetMeeting client applications can save custom data for each individual user on the remote member's Local System object. By using its GUID to tag the data, each application manages and maintains its own data independently of other client applications.

Requirements

**  Windows NT/2000:** Requires Windows NT 4.0 SP3 or later.
**  Windows 95/98:** Requires Windows 95 or later. Available as a redistributable for Windows 95.
**  Header:** Imsconf2.idl.

See Also

INmSysInfo::GetUserData, INmSysInfo::SetUserData, INmMember, Member Object, Member Object Details