Microsoft DirectX 8.0 (C++)

IDirectPlay8LobbiedApplication::RegisterProgram

Registers a lobby-aware application with DirectPlay. Applications must be registered to enable lobby launching.

HRESULT RegisterProgram(
PDPL_PROGRAM_DESC pdplProgramDesc,
const DWORD dwFlags
);

Parameters

pdplProgramDesc
Pointer to the DPL_PROGRAM_DESC structure that describes the lobby-aware application to register.
dwFlags
Reserved. Must be 0.

Return Values

Returns S_OK if successful, or one of the following error values.

DPNERR_INVALIDFLAGS
DPNERR_INVALIDPARAM

Remarks

The application needs to register only once. It should be unregistered with a call to the IDirectPlay8LobbiedApplication::UnRegisterProgram method when it is uninstalled.

In Microsoft DirectX® 8.0, RegisterProgram must be used. You cannot manually enter application information in the registry. Failure to use this interface makes your application nonportable and incompatible with future versions of DirectPlay.

Requirements

  Windows NT/2000: Available as a redistributable for Windows 2000 and later.
  Windows 95/98: Available as a redistributable for Windows 95 and later.
  Header: Declared in Dplobby8.h.