2.2.1.3 DN_CONNECT_FAILED

The DN_CONNECT_FAILED packet indicates that a connection attempt failed.


0


1


2


3


4


5


6


7


8


9

1
0


1


2


3


4


5


6


7


8


9

2
0


1


2


3


4


5


6


7


8


9

3
0


1

dwPacketType

hResultCode

dwReplyOffset

dwReplySize

reply (variable)

...

dwPacketType (4 bytes): A 32-bit field that contains the packet type.

Value

Meaning

DN_MSG_INTERNAL_CONNECT_FAILED

0x000000C5

Connection attempt failed.

hResultCode (4 bytes): A 32-bit field that contains the failure code.

Value

Meaning

DPNERR_ALREADYCLOSING

0x80158050

Server/host is closing or host is migrating.

DPNERR_NOTHOST

0x80158530

Attempting to connect to an application that is not the host/server.

DPNERR_INVALIDINTERFACE

0x80158390

Nonclient attempting to connect to a server. Nonpeer attempting to connect to a host/peer.

DPNERR_INVALIDVERSION

0x80158460

Version passed in is not a valid DirectPlay version.

DPNERR_INVALIDINSTANCE

0x80158380

Instance GUID is not valid for this game session.

DPNERR_INVALIDAPPLICATION

0x80158300

Application GUID is not valid for this application.

DPNERR_INVALIDPASSWORD

0x80158410

Password passed in does not match what is expected.

DPNERR_HOSTREJECTEDCONNECTION

0x80158260

Application declined connection attempt.

DPNERR_GENERIC

0x80004005

An undetermined error occurred inside a DirectX subsystem. This includes uncommon errors that cannot be generalized.

dwReplyOffset (4 bytes): A 32-bit field that specifies the offset from the end of dwPacketType to the reply field. If dwReplyOffset is 0, there is no reply data.

dwReplySize (4 bytes): A 32-bit field that specifies the size, in bytes, of the data in the reply field. If dwReplyOffset is 0, dwReplySize SHOULD also be 0. If dwReplyOffset is not 0, dwReplySize SHOULD also not be 0.

reply (variable): A variable-length field that contains an array of bytes that provides a reply message from the application identifying the connection failure. Reply data is only expected when the failure type is DPNERR_HOSTREJECTEDCONNECTION.