Share via

INmSysInfo::GetUserData

  • Article

Use GetUserData to retrieve private data for the local user associated with a specific globally unique identifier (GUID).

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

Parameters

  • rguid
    [in] A GUID that defines where to get the user data.
  • ppb
    [out] Pointer to the location of the buffer for the user data.
  • pcb
    [out] Pointer to the count of characters in the buffer.

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 was retrieved successfully.
  • NM_E_NOT_ACTIVE
    The conference manager has not been initialized with INmManager::Initialize yet. Unlike other INmSysInfo methods, retrieving user data requires the conference manager to be active.
  • RPC_X_NULL_REF_POINTER
    The value of ppb or pcb was NULL or both pointers were NULL.

Remarks

If the data was retrieved successfully, use CoTaskMemFree to free the data buffer (indicated by ppb) when the data is no longer needed.

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::SetUserData, INmSysInfo, Local System Object, Local System Object Details