DirectPlayLobbyCreate

The DirectPlayLobbyCreate function creates an instance of a DirectPlayLobby object and returns a pointer to the IDirectPlayLobby interface.

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 IDirectPlayLobby3 interface, use this function to get an IDirectPlayLobby interface, then call QueryInterface, as follows:

IDirectPlayLobby->QueryInterface( IID_IDirectPlayLobby3,
        (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 0.

Return Values

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

Requirements

  Windows NT/2000: Requires Windows 2000.
  Windows 95/98: Requires Windows 95 or later. Available as a redistributable for Windows 95.
  Header: Declared in dplobby.h.
  Import Library: Use dplayx.lib.