1.2.7.1 WDRV_PIC32MZW_BSSConnect Function
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
)
C
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
Param | Description |
handle | Client handle obtained by a call to WDRV_PIC32MZW_Open. |
pBSSCtx | Pointer to BSS context. |
pAuthCtx | Pointer to authentication context. |
pfNotifyCallback | Pointer 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.