WCM_CountApList

C Specification


#include <nitroWiFi/wcm.h>

s32   WCM_CountApList( void );
				

Description

A synchronous function that obtains the number of devices found during wireless access point auto-search and listed in the internal buffer. Because the internal list is initialized by the WCM_ClearApList function, the number of devices is also initialized to 0. Also, if a valid buffer for the internal list is not provided when WCM_StartupAsync is called, there is no listing made in the internal buffer, so this function always returns 0. If the function is called before the WCM library is initialized, it will return 0. During wireless access point auto-search, the internal list buffer's state can be changed at random times. Accordingly, we recommend using this function after disabling updates of the internal list by calling WCM_LockApList function.

Arguments

None.

Return Values

Returns the number of wireless access point information sets listed in the internal buffer.

See Also

WCM_StartupAsync, WCMConfig, WCM_LockApList, WCM_ClearApList, WCM_PointApList, WCM_PointApListLinkLevel

Revision History

07/22/2005 Initial version.