1.3.7.1 WDRV_PIC32MZW_BSSConnect Function

C

WDRV_PIC32MZW_STATUS WDRV_PIC32MZW_BSSConnect
(
DRV_HANDLE handle,
const WDRV_PIC32MZW_BSS_CONTEXT *const pBSSCtx,
const WDRV_PIC32MZW_AUTH_CONTEXT *const pAuthCtx,
const WDRV_PIC32MZW_BSSCON_NOTIFY_CALLBACK pfNotifyCallback
)

Summary

Connects to a BSS in infrastructure station mode.

Description

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

Precondition

WDRV_PIC32MZW_Initialize should have been called. WDRV_PIC32MZW_Open should 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

ParamDescription
handleClient handle obtained by a call to WDRV_PIC32MZW_Open.
pBSSCtxPointer to BSS context.
pAuthCtxPointer to authentication context.
pfNotifyCallbackPointer to notification callback function.

Returns

WDRV_PIC32MZW_STATUS_OK - The request has been accepted.

WDRV_PIC32MZW_STATUS_NOT_OPEN - The driver instance is not open.

WDRV_PIC32MZW_STATUS_INVALID_ARG - The parameters were incorrect.

WDRV_PIC32MZW_STATUS_REQUEST_ERROR - The request to the PIC32MZW was rejected.

WDRV_PIC32MZW_STATUS_INVALID_CONTEXT - The BSS context is not valid.

WDRV_PIC32MZW_STATUS_CONNECT_FAIL - The connection has failed.

Remarks

If pBSSCtx and pAuthCtx are both NULL then no connection will be attempted, however the pfNotifyCallback callback will still be accepted, even if a connection is active.