1.1.27.3 WDRV_WINC_BSSConnect

C

WDRV_WINC_STATUS WDRV_WINC_BSSConnect
(
    DRV_HANDLE handle,
    const WDRV_WINC_BSS_CONTEXT *const pBSSCtx,
    const WDRV_WINC_AUTH_CONTEXT *const pAuthCtx,
    const WDRV_WINC_CONN_CFG *pWiFiCfg,
    const WDRV_WINC_BSSCON_NOTIFY_CALLBACK pfNotifyCallback
)

Description

Using the defined BSS and authentication contexts this function requests the WINC connect to the BSS as an infrastructure station.

Precondition

WDRV_WINC_Initialize must have been called.

WDRV_WINC_Open must have been called to obtain a valid handle.

A BSS context must have been created and initialized.

An authentication context must have been created and initialized.

Parameters

ParametersDescription
handleClient handle obtained by a call to WDRV_WINC_Open.
pBSSCtxPointer to BSS context.
pAuthCtxPointer to authentication context.
pWiFiCfgOptional WiFi configuration.
pfNotifyCallbackPointer to notification callback function.

Returns

  • WDRV_WINC_STATUS_OK - The request has been accepted.

  • WDRV_WINC_STATUS_NOT_OPEN - The driver instance is not open.

  • WDRV_WINC_STATUS_INVALID_ARG - The parameters were incorrect.

  • WDRV_WINC_STATUS_REQUEST_ERROR - The request to the WINC was rejected.

  • WDRV_WINC_STATUS_INVALID_CONTEXT - The BSS context is not valid.

  • *WDRV_WINC_STATUS_CONNECT_FAIL - The connection has failed.

Remarks

None.