# WMStartConnectCallback

## C Specification

  `#include <nitro/wm.h>`

      typedef struct WMStartConnectCallback
      {
          u16     apiid;
          u16     errcode;
          u16     wlCmdID;
          u16     wlResult;
          u16     state;
          u16     aid;
          u16     reason;

      } WMStartConnectCallback;

## Description

This structure is passed to the callback function related to `WM_StartConnect`.

## Arguments

`apiid` | Specifies the ID of the function that has become the callback generation source. This argument is the same as the `WMApiid` enumerated type. Here, it is fixed as `WM_APIID_START_CONNECT`.
`errcode` | Specifies the asynchronous process results. This argument is the same as the `WMErrCode` enumerated type.
`wlCmdID` | If `errcode` is `WM_ERRCODE_FAILED,` this function will store the ID of the command that was an error in the wireless firmware.
`wlResult` | If `errcode` is `WM_ERRCODE_FAILED`, this function will store the code that was the source of the error in the wireless firmware.
`state` | If `errcode` is `WM_ERRCODE_SUCCESS`, the `WM Cause Code` that generated the callback will be stored. There are four causes: `WM_STATECODE_CONNECT_START, WM_STATECODE_CONNECTED, WM_STATECODE_BEACON_LOST, WM_STATECODE_DISCONNECTED`.
`aid` | If `state` is `WM_STATECODE_CONNECTED`, the AID that is allocated by the parent will be stored.
`reason` | Stores the code showing the reason for disconnection when the state is `WM_STATECODE_DISCONNECTED`. This argument is used internally for debugging the library.

## Revision History

11/10/2004 Added text about the `reason` argument.
08/02/2004 Standardized structure names.
07/29/2004 Initial version.