DirectPlay Animated Header -- IDirectPlay3::GetGroupData DirectPlay Animated Header -- IDirectPlay3::GetGroupData* Microsoft DirectPlay SDK
*Index  *Topic Contents
*Previous Topic: IDirectPlay3::GetGroupConnectionSettings
*Next Topic: IDirectPlay3::GetGroupFlags


IDirectPlay3::GetGroupData


IDirectPlay3 Interface

Retrieves an application-specific data block that was associated with a group ID by using IDirectPlay3::SetGroupData.

HRESULT GetGroupData(
  DPID idGroup,
  LPVOID lpData,
  LPDWORD lpdwDataSize,
  DWORD dwFlags
  );

Parameters
idGroup
Group ID for which data is being requested.
lpData
Pointer to a buffer where the application-specific group data is to be written. Set this parameter to NULL to request only the size of data. The lpdwDataSize parameter will be set to the size required to hold the data.
lpdwDataSize
Pointer to a variable that is initialized to the size of the buffer before calling the method. After the method returns, this parameter will be set to the size, in bytes, of the group data. If the buffer was too small (DPERR_BUFFERTOOSMALL), then this parameter will be set to the buffer size required.
dwFlags
If this parameter is set to 0, the remote data will be retrieved.
DPGET_LOCAL
Retrieves the local data set by this application
DPGET_REMOTE
Retrieves the current data from the remote shared data space.
Return Values

Returns DP_OK if successful, or one of the following error values otherwise:

DPERR_BUFFERTOOSMALL
DPERR_INVALIDGROUP
DPERR_INVALIDOBJECT
DPERR_INVALIDPARAMS
DPERR_INVALIDPLAYER
Remarks

DirectPlay can maintain two types of group data: local and remote. The application must specify which type of data to retrieve. Local data was set by this DirectPlay object by using the DPSET_LOCAL flag. Remote data might have been set by any application in the session by using the DPSET_REMOTE flag.

See Also

IDirectPlay3::SetGroupData

© 1998 Microsoft Corporation. All rights reserved. Terms of Use.

*Top of Page