WlanSetProfileList (Compact 2013)

3/26/2014

This function sets the preference order of profiles for a given interface.

Syntax

DWORD WINAPI WlanSetProfileList(
  __in        HANDLE hClientHandle,
  __in        const GUID* pInterfaceGuid,
  __in        DWORD dwItems,
  __in        LPCWSTR* strProfileNames,
  __reserved  PVOID pReserved 
);

Parameters

• hClientHandle
  [in] Handle to the session on the client. To obtain a handle, call the WlanOpenHandle function.

• pInterfaceGuid
  [in] GUID of the interface.

• dwItems
  [in] Number of profiles in the strProfileNames parameter.

• strProfileNames
  [in] Names of the profiles in the desired order. Profile names are case sensitive and the string must be NULL terminated.

• pReserved
  Reserved; set to NULL.

Return Values

Value	Description
ERROR_SUCCESS	The function succeeds.
ERROR_ACCESS_DENIED	You included Connection Manager in your OS. The caller does not have sufficient permissions to change the profile list.
ERROR_INVALID_HANDLE	The handle hClientHandle was not found in the handle table.
ERROR_INVALID_PARAMETER	One of the following conditions occurred: hClientHandle is NULL or invalid pInterfaceGuid is NULL dwItems is 0 strProfileNames is NULL The same profile name appears multiple times in strProfileNames pReserved is not NULL
ERROR_NOT_FOUND	strProfileNames contains the name of a profile that is not present in the profile store.
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.

Remarks

If you include Connection Manager in your OS design:

• You must handle Wi-Fi connection operations using Connection Manager APIs such as CmAcquireConnection, CmAddConnectionConfig, or CmReleaseConnection.
• Otherwise, if you use this API, it returns ERROR_ACCESS_DENIED.

See Also

Reference

Native Wi-Fi Functions
WlanOpenHandle
WlanGetProfileList
Native Wi-Fi Reference