| Microsoft DirectX 9.0 SDK Update (Summer 2003) |
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