Microsoft DirectX 8.0 (C++)

IDirectPlay8Peer::GetConnectionInfo

Retrieves statistical information about the connection between the local application and the specified remote player.

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

Parameters

dpnidEndPoint
The DPNID of the remote player whose connection information will be retrieved.
pdnConnectInfo
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
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
DPNERR_INVALIDPLAYER

Remarks

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

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