1.1.6.8 WDRV_WINC_AssocDisconnect

C

WDRV_WINC_STATUS WDRV_WINC_AssocDisconnect
(
    WDRV_WINC_ASSOC_HANDLE assocHandle
)

Description

This API disconnects the STA associated with softAP based on the input association handle. Association handle is updated to the application whenever a new STA is connected to the softAP.

This API can also be used in STA mode to disconnect the STA from an AP.

Precondition

WDRV_WINC_Initialize must have been called.

WDRV_WINC_Open must have been called to obtain a valid handle.

WDRV_WINC_APStart must have been called to start softAP in softAP mode.

WDRV_WINC_BSSConnect must have been called to connect to an AP in STA mode.

Parameters

ParametersDescription
assocHandleWDRV_WINC_ASSOC_HANDLE obtained when STA joins an AP or an association is done.

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_NOT_CONNECTED - The association is not valid.

Remarks

This function is currently not implemented and should not be used.