Microsoft DirectX 8.1 (C++)

IDirectPlay8LobbiedApplication::UpdateStatus

Updates the status of a connected lobby client.

HRESULT UpdateStatus(
const DPNHANDLE hConnection,
const DWORD dwStatus,
const DWORD dwFlags
);

Parameters

hConnection
[in] Variable of type DPNHANDLE that specifies the lobby client. You may also specify the following flag.
DPLHANDLE_ALLCONNECTIONS
The status update will be sent to all lobby clients to which you are connected.
dwStatus
[in] Variable of type DWORD that is filled with one of the following values that indicate the status between the lobby client and the lobbied application.
DPLSESSION_CONNECTED
The lobby client and lobbied application are currently connected.
DPLSESSION_COULDNOTCONNECT
The lobby client was not able to connect to the lobbied application.
DPLSESSION_DISCONNECTED
The lobby client and lobbied application are currently disconnected.
DPLSESSION_TERMINATED
The connection between the lobby client and lobbied application has been terminated.
DPLSESSION_HOSTMIGRATED
The peer object associated with the connection is involved in a session where a host migration takes place and the local client is not the new host.
DPLSESSION_HOSTMIGRATEDHERE
The peer object associated with the connection is involved in a session where a host migration takes place and the local client becomes the new host.
dwFlags
[in] Reserved, must be 0.

Return Values

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

DPNERR_INVALIDHANDLE
DPNERR_INVALIDPARAM

Requirements

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