#include <nitroWiFi/wcm.h>
s32 WCM_DisconnectAsync( void );
An asynchronous function that initiates the sequence to disconnect from a connected wireless access point. If the asynchronous process starts normally, the internal state changes from WCM_PHASE_DCF
to WCM_PHASE_DCF_TO_IDLE
; when the asynchronous process completes normally, it becomes WCM_PHASE_IDLE
. This function can only be executed in these internal states. When the return value is WCM_RESULT_ACCEPT
, the corresponding asynchronous process notification will be generated once and the callback function is called.
None.
Returns one of the following process results.
WCM_RESULT_ACCEPT |
Indicates that the request to start the asynchronous sequence was accepted and that the asynchronous process started normally. When the asynchronous process ends, the callback function will be called once. |
WCM_RESULT_PROGRESS |
Indicates that the asynchronous sequence started by this function is already executing and this was a duplicate call. Even with duplicate calls, the asynchronous process completion notification is generated only once. |
WCM_RESULT_SUCCESS |
Indicates that the sequence for disconnection from a wireless access point has already completed, and the internal state was WCM_PHASE_IDLE . Since the asynchronous process is not started, an asynchronous process completion notification is not generated. |
WCM_RESULT_REJECT |
Indicates that when the function attempted to initiate the disconnect sequence from a wireless access point, it was not successful in issuing a PXI process request to the ARM7. The internal state remains WCM_PHASE_DCF and another attempt can be made. |
WCM_RESULT_FAILURE |
Indicates that the process failed because the WCM library was not initialized or the internal state was not WCM_PHASE_DCF , WCM_PHASE_DCF_TO_IDLE , or WCM_PHASE_IDLE , etc. |
WCM_RESULT_FATAL_ERROR |
Indicates that an unrecoverable error has occurred. Internal state becomes WCM_PHASE_FATAL_ERROR and does not change thereafter. |
One of the following asynchronous process results is passed to the callback function specified by WCM_StartupAsync
function. The notification type is always WCM_NOTIFY_DISCONNECT
.
Note that the notification type is the same as the notification for disconnection from a wireless access point that may occur asynchronously during communication.
WCM_RESULT_SUCCESS |
Indicates that the asynchronous process succeeded and that the wireless access point was disconnected normally. The internal state becomes WCM_PHASE_IDLE . |
WCM_RESULT_FAILURE |
Indicates that an error notification was received from the WM library during the asynchronous process. The internal state becomes WCM_PHASE_IRREGULAR . |
WCM_RESULT_FATAL_ERROR |
Indicates that an unrecoverable error occurred during the asynchronous process. Internal state becomes WCM_PHASE_FATAL_ERROR and does not change thereafter. |
WCM_ConnectAsync, WCM_TerminateAsync
07/22/2005 Initial version.