##

IDirectPlay3::GetSessionDesc

IDirectPlay3 Interface

Retrieves the properties of the current open session.

HRESULT GetSessionDesc(
LPVOID lpData,
LPDWORD lpdwDataSize
);

##### Parameters

lpData
  Pointer to a buffer where the session description 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 this 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. If this parameter is NULL, the method returns DPERR_INVALIDPARAM.

##### Return Values

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

DPERR_BUFFERTOOSMALL
DPERR_INVALIDOBJECT
DPERR_INVALIDPARAMS
DPERR_NOCONNECTION

##### Remarks

After this method returns, the pointer lpData should be cast to the DPSESSIONDESC2 structure to read the session description data.

##### See Also

DPSESSIONDESC2, IDirectPlay3::EnumSessions, IDirectPlay3::Open

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