NWMUDS:GetConnectionStatus

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 Unknown u32. Official user-processes check for values: 0x0, 0x1, and non-zero.
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.
0xB For this value official user-processes use NWMUDS:UpdateNetworkAttribute to clear attributes bitmask 0x6.

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.

The event is not signalled when using NWMUDS:DestroyNetwork or NWMUDS:DisconnectNetwork. However the event does get signalled when creating or connecting to a network.