Was this page helpful?
Your feedback about this content is important. Let us know what you think.
Additional feedback?
1500 characters remaining
Export (0) Print
Expand All
Expand Minimize

WlanRenameProfile function

The WlanRenameProfile function renames the specified profile.

Syntax


DWORD WINAPI WlanRenameProfile(
  _In_       HANDLE  hClientHandle,
  _In_ const GUID    *pInterfaceGuid,
  _In_       LPCWSTR strOldProfileName,
  _In_       LPCWSTR strNewProfileName,
             PVOID   pReserved
);

Parameters

hClientHandle [in]

The client's session handle, obtained by a previous call to the WlanOpenHandle function.

pInterfaceGuid [in]

The GUID of the interface.

strOldProfileName [in]

The profile name to be changed.

strNewProfileName [in]

The new name of the profile.

pReserved

Reserved for future use. Must be set to NULL.

Return value

If the function succeeds, the return value is ERROR_SUCCESS.

If the function fails, the return value may be one of the following return codes.

Return codeDescription
ERROR_INVALID PARAMETER

hClientHandle is NULL or not valid, pInterfaceGuid is NULL, strOldProfileName is NULL, strNewProfileName is NULL, or pReserved is not NULL.

ERROR_INVALID_HANDLE

The handle hClientHandle was not found in the handle table.

ERROR_NOT_FOUND

The profile specified by strOldProfileName was not found in the profile store.

ERROR_ACCESS_DENIED

The caller does not have sufficient permissions to rename the profile.

ERROR_NOT_SUPPORTED

This function was called from an unsupported platform. This value will be returned if this function was called from a Windows XP with SP3 or Wireless LAN API for Windows XP with SP2 client.

RPC_STATUS

Various error codes.

 

Requirements

Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]

Header

Wlanapi.h (include Wlanapi.h)

Library

Wlanapi.lib

DLL

Wlanapi.dll

See also

WlanGetProfile
WlanDeleteProfile
WlanSetProfile

 

 

Community Additions

ADD
Show:
© 2015 Microsoft