#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 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
2005/07/22 Initial version.
CONFIDENTIAL