2.2.50 DPSP_MSG_REQUESTPLAYERREPLY

The DPSP_MSG_REQUESTPLAYERREPLY packet is sent in response to a DPSP_MSG_REQUESTPLAYERID (section 2.2.49) or DPSP_MSG_REQUESTGROUPID (section 2.2.48) message. The reply message contains either a new player ID or a new group identifier.


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

DPSP_MSG_HEADER (28 bytes)

...

...

ID

SecDesc (24 bytes)

...

...

SSPIProviderOffset

CAPIProviderOffset

Result

SSPIProvider (variable)

...

CAPIProvider (variable)

...

DPSP_MSG_HEADER (28 bytes): Message header for this packet. The Command Value member of this field MUST be set to 7 (0x07).

ID (4 bytes): MUST be set to the new player (or group) identifier.

SecDesc (24 bytes):  MUST be set to a DPSECURITYDESC (section 2.2.4) structure that contains the security properties of the DirectPlay game session instance.

SSPIProviderOffset (4 bytes): MUST be set to the offset, in octets, of the Security Support Provider Interface (SSPI) provider name from the beginning of the message. Zero means that the game session is not secure.

CAPIProviderOffset (4 bytes): MUST be set to the offset, in octets, of the Crypto API [MSDN-CAPI] provider name from the beginning of the message. Zero means that the game session will not use encryption.

Result (4 bytes): MUST be set to a Win32 HRESULT error code. If 0, the request succeeded; if nonzero, indicates the reason the request failed. For a complete list of HRESULT codes, see [MS-ERREF].

SSPIProvider (variable): Null-terminated Unicode string that contains the SSPI name. If no SSPI provider is specified, the game session is not a secure game session.

CAPIProvider (variable): Null-terminated Unicode string that contains the Crypto API provider name. For a list of provider names, see Cryptographic Provider Names.