DPN_MSGID_CONNECT_COMPLETE

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. This message is generated whether or not the connection was successful.

DPNMSG_CONNECT_COMPLETE

The DPNMSG_CONNECT_COMPLETE structure contains information for the DPN_MSGID_CONNECT_COMPLETE system message.

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

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.

Return Values

Return DPN_OK.

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.