WlanGetProfileList (Compact 7)

3/12/2014

This function retrieves the list of profiles in preference order.

Syntax

DWORD WINAPI WlanGetProfileList(
  __in          HANDLE hClientHandle,
  __in          const GUID* pInterfaceGuid,
  __reserved    PVOID pReserved,
    __deref__out  PWLAN_PROFILE_INFO_LIST* ppProfileList
);

Parameters

  • hClientHandle
    [in] Handle to the session on the client. To obtain a handle, call the WlanOpenHandle function.
  • pInterfaceGuid
    [in] GUID of the interface.
  • pReserved
    Reserved; set to NULL.

Return Values

Value Description

ERROR_SUCCESS

The function succeeds.

ERROR_ACCESS_DENIED

You included Connection Manager in your OS.

ERROR_INVALID_PARAMETER

One of the following:

  • hClientHandle is NULL or invalid
  • pInterfaceGuid is NULL
  • ppProfileList is NULL
  • pReserved is not NULL

ERROR_INVALID_HANDLE

The handle hClientHandle was not found in the handle table.

RPC_STATUS

Can be any Remote Procedure Call (RPC) error code. The RPC call may be unsuccessful due to Wlan RPC server issues, such as when the RPC server is not started. Refer to RPC for more information.

ERROR_NOT_ENOUGH_MEMORY

Could not allocate memory for the profile list.

Remarks

If you include Connection Manager in your OS design:

This function returns only the basic information about the profiles. You can retrieve the full content of a profile by using the WlanGetProfile function.

This function allocates memory. To free the memory, you must call the WlanFreeMemory function.

See Also

Reference

Native Wi-Fi Functions
WlanOpenHandle
WlanGetProfile
WlanFreeMemory
WLAN_PROFILE_INFO_LIST
WlanSetProfileList
Native Wi-Fi Reference