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