Microsoft DirectX 8.1 (C++)

IDirectPlay8Server::GetConnectionInfo

Retrieves statistical information about the connection between the local server and the specified remote client.

HRESULT GetConnectionInfo(
const DPNID dpnidEndPoint,
DPN_CONNECTION_INFO *const pdnConnectInfo,
const DWORD dwFlags
);

Parameters

dpnidEndPoint
[in] DPNID of the player whose connection information will be retrieved.
pdnConnectInfo
[out] Pointer to a DPN_CONNECTION_INFO structure to retrieve information about the specified connection. The dwSize member of this structure must be set to the size of a DPN_CONNECTION_INFO structure.
dwFlags
[in] Reserved. Must be 0.

Return Values

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

DPNERR_INVALIDOBJECT
DPNERR_INVALIDPARAM
DPNERR_INVALIDPOINTER
DPNERR_UNINITIALIZED

Remarks

This method can be called only after a successful Host call has completed.

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 Dplay8.h.