2.2.22 DPSP_MSG_CREATEPLAYERVERIFY

A DPSP_MSG_CREATEPLAYERVERIFY message is sent as verification that a player was previously created. When all of the following conditions are met, one or more DPSP_MSG_CREATEPLAYERVERIFY messages are sent in response to a DPSP_MSG_CREATEPLAYER (section 2.2.21) message:

  • The receiving computer system is not the host.

  • The player referenced in the incoming DPSP_MSG_CREATEPLAYER message has not already been added to the name table.

  • The player referenced in the incoming DPSP_MSG_CREATEPLAYER message is not a system player.

  • The value of the Version field of the received DPSP_MSG_HEADER (section 2.2.6) of the message is 13 or higher.

  • The receiving computer system created a local player that was not designated as a system player within the last 40 seconds. If more than one local player has been created within that time period, then a separate DPSP_MSG_CREATEPLAYERVERIFY message MUST be sent for each player.


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)

...

...

IDTo

PlayerID

GroupID

CreateOffset

PasswordOffset

PlayerInfo (variable)

...

Reserved1

Reserved2

...

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

IDTo (4 bytes): The player to whom the message is being sent. SHOULD be set to zero when sent and MUST be ignored on receipt.

PlayerID (4 bytes): MUST be set to the identifier of the previously created player.

GroupID (4 bytes): Ignored. SHOULD be set to zero when sent and MUST be ignored on receipt.

CreateOffset (4 bytes): Offset, in octets, of the PlayerInfo field. MUST be set to 28 (0x0000001C).

PasswordOffset (4 bytes): Not used. SHOULD be set to zero when sent and MUST be ignored on receipt.

PlayerInfo (variable): MUST contain a DPLAYI_PACKEDPLAYER (2.2.2) structure containing the information about the previously created player.

Reserved1 (2 bytes): SHOULD be set to zero when sent and MUST be ignored on receipt.

Reserved2 (4 bytes): SHOULD be set to zero when sent and MUST be ignored on receipt.