2.2.1.5 DN_NAMETABLE_ENTRY_INFO

The DN_NAMETABLE_ENTRY_INFO contains a player or group that exists in a DirectPlay 8 name table. This includes all the information that the DirectPlay 8 Protocol: Core and Service Providers would need about a certain entry.

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
dpnid
dpnidOwner
dwFlags
dwVersion
dwVersionNotUsed
dwDNETVersion
dwNameOffset
dwNameSize
dwDataOffset
dwDataSize
dwURLOffset
dwURLSize

dpnid (4 bytes): A 32-bit integer that specifies the DirectPlay identifier (DPNID) of the player or group that has been defined by the host/server. For more information about DPNIDs, see section 2.2.7.

dpnidOwner (4 bytes): A 32-bit integer that provides the DirectPlay identifier (DPNID) for the owner of the player or group. When the DN_NAMETABLE_ENTRY_INFO message represents a group, that is, NAMETABLE_ENTRY_FLAG_GROUP is set in the dwFlags field, the dpnidOwner field MUST be nonzero. When DN_NAMETABLE_ENTRY_INFO represents a player, dpnidOwner SHOULD be set to zero when sending and MUST be ignored on receipt. For more information about DPNIDs, see section 2.2.7.

dwFlags (4 bytes): A 32-bit integer that specifies the name table entry flags. Entries are OR'd together.

Value	Meaning
NAMETABLE_ENTRY_FLAG_LOCAL 0x00000001	The name table entry is the local player.
NAMETABLE_ENTRY_FLAG_HOST 0x00000002	The name table entry is the host.
NAMETABLE_ENTRY_FLAG_ALL_PLAYERS_GROUP 0x00000004	The name table entry is the All Players Group.
NAMETABLE_ENTRY_FLAG_GROUP 0x00000010	The name table entry is a group.
NAMETABLE_ENTRY_FLAG_GROUP_AUTODESTRUCT 0x00000040	The name table entry supports group autodestruct.
NAMETABLE_ENTRY_FLAG_PEER 0x00000100	The name table entry is a peer. In peer-to-peer mode, the name table entry representing the host of the game session is also marked as a peer.
NAMETABLE_ENTRY_FLAG_CLIENT 0x00000200	The name table entry is a client.
NAMETABLE_ENTRY_FLAG_SERVER 0x00000400	The name table entry is a server.
NAMETABLE_ENTRY_FLAG_CONNECTING 0x00001000	The name table entry is connecting.
NAMETABLE_ENTRY_FLAG_AVAILABLE 0x00002000	The name table entry is to make the member available for use.
NAMETABLE_ENTRY_FLAG_DISCONNECTING 0x00004000	The name table entry to indicate disconnecting.
NAMETABLE_ENTRY_FLAG_INDICATED 0x00010000	The name table entry to indicate connection to the application.
NAMETABLE_ENTRY_FLAG_CREATED 0x00020000	The name table entry to indicate the application was given a created player.
NAMETABLE_ENTRY_FLAG_NEED_TO_DESTROY 0x00040000	The name table entry to indicate the need to destroy the player.
NAMETABLE_ENTRY_FLAG_IN_USE 0x00080000	The name table entry to indicate that the player is in use.

dwVersion (4 bytes): A 32-bit integer that specifies the version number of the name table.

dwVersionNotUsed (4 bytes): Not used.

dwDNETVersion (4 bytes): A 32-bit integer that provides the DirectPlay version.

Value	Meaning
0x00000001	DirectX 8.0
0x00000002	DirectX 8.1
0x00000003	PocketPC
0x00000004	Not used.
0x00000005	Windows Server 2003 operating system
0x00000006	DirectX 8.2
0x00000007	DirectX 9.0
0x00000008	DirectX 9.0

dwNameOffset (4 bytes): The offset, in bytes, from the end of dwPacketType to the name field. (Defined in DN_SEND_CONNECT_INFO). If dwNameOffset is 0, there is not a name.

dwNameSize (4 bytes): The size, in bytes, of the name field. (Specified in section 2.2.1.4). If dwNameOffset is 0, dwNameSize SHOULD also be 0. If dwNameOffset is not 0, dwNameSize SHOULD also not be 0.

dwDataOffset (4 bytes): The offset, in bytes, from the end of dwPacketType to the data field. If dwDataOffset is 0, there is no additional data.

dwDataSize (4 bytes): The size, in bytes, of the data field. If dwDataOffset is 0, dwDataSize SHOULD also be 0. If dwDataOffset is not 0, dwDataSize SHOULD also not be 0.

dwURLOffset (4 bytes): The offset, in bytes, from the end of dwPacketType to the url field. Specified in section 2.2.8).

dwURLSize (4 bytes): The size, in bytes, of the url field.