MPDisconnectReason

Definitions

#include <revolution/mp.h>

enum
{
    // the reason value related to an externally-cause disconnection
    MP_DISCONNECT_REASON_RESERVED                      = 0,
    MP_DISCONNECT_REASON_UNSPECIFIED                   = 1,
    MP_DISCONNECT_REASON_PREV_AUTH_INVALID             = 2,
    MP_DISCONNECT_REASON_DEAUTH_LEAVING                = 3,
    MP_DISCONNECT_REASON_INACTIVE                      = 4,
    MP_DISCONNECT_REASON_UNABLE_HANDLE                 = 5,
    MP_DISCONNECT_REASON_RX_CLASS2_FROM_NONAUTH_STA    = 6,
    MP_DISCONNECT_REASON_RX_CLASS3_FROM_NONASSOC_STA   = 7,
    MP_DISCONNECT_REASON_DISASSOC_LEAVING              = 8,
    MP_DISCONNECT_REASON_ASSOC_STA_NOTAUTHED           = 9,

    // the reason values unique to Wii-DS' local communications
    MP_DISCONNECT_REASON_NO_ENTRY                      = 19,

    // the reason values related to internal automatic disconnects from the library
    MP_DISCONNECT_REASON_MP_LIFETIME                   = 0x8001,
    MP_DISCONNECT_REASON_UPDATE                        = 0xc001,
    MP_DISCONNECT_REASON_DEPRIVED_AID                  = 0xc002,

    // the reason values related to an explicit disconnection by the library
    MP_DISCONNECT_REASON_RESET                         = 0xf001,
    MP_DISCONNECT_REASON_ACTIVE                        = 0xf002
} MPDisconnectReason;

Description

Enumerated type to indicate the reason code for a disconnection.

It is possible to determine using the function macro, MP_IS_DISCONNECTED_FROM_MYSELF(reason), whether an MP library function was actively called for a disconnection.

Member Description
MP_DISCONNECT_REASON_RESERVED Reserved
MP_DISCONNECT_REASON_UNSPECIFIED Indicates that an unspecified error has occurred.
MP_DISCONNECT_REASON_PREV_AUTH_INVALID Indicates that the previous authentication is no longer valid.
MP_DISCONNECT_REASON_DEAUTH_LEAVING Indicates that authorization was removed because the BSS has been left.
MP_DISCONNECT_REASON_INACTIVE Indicates that a connection was lost due to inactivity.
MP_DISCONNECT_REASON_UNABLE_HANDLE Indicates the connection was lost because the AP had insufficient resources.
MP_DISCONNECT_REASON_RX_CLASS2_FROM_NONAUTH_STA Indicates that a Class2 frame was received from an unauthenticated STA.
MP_DISCONNECT_REASON_RX_CLASS3_FROM_NONASSOC_STA Indicates that a Class3 frame was received from a disconnected STA.
MP_DISCONNECT_REASON_DISASSOC_LEAVING Indicates that association was removed because the BSS has been left.
MP_DISCONNECT_REASON_ASSOC_STA_NOTAUTHED Indicates that the requested STA has not yet received authentication.
MP_DISCONNECT_REASON_NO_ENTRY Indicates that the parent is not yet in receipt of the current entry.
MP_DISCONNECT_REASON_MP_LIFETIME Indicates that the MP communications lifetime has expired.
MP_DISCONNECT_REASON_UPDATE Indicates that the child device in questions was re-registered with a different AID.
MP_DISCONNECT_REASON_DEPRIVED_AID Indicates that another communications partner has registered with the same AID number.
MP_DISCONNECT_REASON_RESET Indicates a disconnection resulting from a reset process.
MP_DISCONNECT_REASON_ACTIVE Indicates disconnection from self resulting from a disconnect function.

Revision History

2006/07/03 Initial version.


CONFIDENTIAL