DirectPlay Animated Header -- DirectPlayLobbyCreate DirectPlay Animated Header -- DirectPlayLobbyCreate* Microsoft DirectPlay SDK
*Index  *Topic Contents
*Previous Topic: DirectPlayEnumerate
*Next Topic: Callback Functions


DirectPlayLobbyCreate


Creates an instance of a DirectPlayLobby object. This function attempts to initialize a DirectPlayLobby object and set a pointer to it.

HRESULT WINAPI DirectPlayLobbyCreate(
  LPGUID lpGUIDSP,
  LPDIRECTPLAYLOBBY *lplpDPL,
  IUnknown *lpUnk,
  LPVOID lpData,
  DWORD dwDataSize
  );

Parameters
lpGUIDSP
Reserved for future use; must be set to NULL.
lplpDPL
Pointer to a pointer to be initialized with a valid IDirectPlayLobby interface. To get an IDirectPlayLobby2 interface, use this function to get an IDirectPlayLobby interface, then call:
  IDirectPlayLobby->QueryInterface( IID_IDirectPlayLobby2, (LPVOID*) &lpDP2 ); 
lpUnk
Pointer to the containing IUnknown interface. This parameter is provided for future compatibility with COM aggregation features. Presently, however, DirectPlayLobbyCreate returns an error if this parameter is anything but NULL.
lpData
Extra data needed to create the DirectPlayLobby object. This parameter must be set to NULL.
dwDataSize
This parameter must be set to zero.
Return Values

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

CLASS_E_NOAGGREGATION
DPERR_INVALIDPARAMS
DPERR_OUTOFMEMORY

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

*Top of Page