DPN_MSGID_CONNECT_COMPLETE Message

Microsoft® DirectPlay® generates the DPN_MSGID_CONNECT_COMPLETE message when the connection attempt has been completed in a peer-to-peer or client/server session.

The DPNMSG_CONNECT_COMPLETE structure contains information for the DPN_MSGID_CONNECT_COMPLETE system message.

Syntax

typedef struct _DPNMSG_CONNECT_COMPLETE {
    DWORD dwSize;
    DPNHANDLE hAsyncOp;
    PVOID pvUserContext;
    HRESULT hResultCode;
    PVOID pvApplicationReplyData;
    DWORD dwApplicationReplyDataSize;
    DPNID dpnidLocal;
}  DPNMSG_CONNECT_COMPLETE, *PDPNMSG_CONNECT_COMPLETE;

Members

dwSize

Size of this structure.

hAsyncOp

Asynchronous operation handle.

pvUserContext

User context supplied when the IDirectPlay8Peer::Connect or IDirectPlay8Client::Connect methods are called.

hResultCode

HRESULT describing the result of the connection attempt. See the Return Values section in the IDirectPlay8Peer::Connect or IDirectPlay8Client::Connect method for more information. Additionally, DPNERR_PLAYERNOTREACHABLE will be returned if a player has tried to join a peer-to-peer session where at least one other existing player in the session cannot connect to the joining player.

pvApplicationReplyData

Connection reply data returned from the host or server.

dwApplicationReplyDataSize

Size of the data, in bytes, of the pvApplicationReplyData member.

dpnidLocal

Specifies the DPNID of the local player.

Remarks

Return from the message callback function with DPN_OK.

This message is generated whether or not the connection was successful.

Message Information

Header	dplay8.h
Minimum availability	DirectX 9.0
Minimum operating systems	Windows 2000, Windows 98