NWMUDS:GetConnectionStatus

Revision as of 21:45, 7 April 2016 by Mtheall (talk | contribs)

Request

Index Word Description
0 Header code [0x000B0000]

Response

Index Word Description
0 Header code
1 Result code
2-13 Output 0x30-byte structure.

Output structure

Offset Size Description
0x0 0x4 u32 status
0x4 0x4 ?
0x8 0x2 u16 NetworkNodeID for this device.
0xA 0x22 ?
0x2C 0x1 u8 total_nodes.
0x2D 0x1 u8 max_nodes, originally from the NetworkStruct.
0x2E 0x2 u16 node_bitmask. This is a bitmask of NetworkNodeIDs: bit0 for NetworkNodeID 0x1(host), bit1 for NetworkNodeID 0x2(first original client), and so on.

Status values

Type Description
0x3 Not connected to any network as a host/client.
0x6 Connected to a network as a host.
0x9 Connected to a network as a client.
0xA Connected to a network as a spectator.

Description

This is mainly used when the event handle from NWMUDS:Initialize is signalled. This is also used before using NWMUDS:Bind. For certain user-processes this may be used during NWMUDS initialization as well.