IDirectPlay8Server::GetConnectionInfo Method

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

Syntax

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 Value

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

DPNERR_INVALIDOBJECT	The Microsoft® DirectPlay® object pointer is invalid.
DPNERR_INVALIDPARAM	One or more of the parameters passed to the method are invalid.
DPNERR_INVALIDPOINTER	Pointer specified as a parameter is invalid.
DPNERR_UNINITIALIZED	The requested object has not been initialized.

Remarks

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