WlanRenameProfile (Compact 7)

3/12/2014

This function renames a profile.

Syntax

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

Parameters

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

• pInterfaceGuid
  [in] GUID of the interface.

• strOldProfileName
  [in] Profile name to be changed.

• strNewProfileName
  [in] New name of the profile.

• pReserved
  Reserved; set to NULL.

Return Values

Value	Description
ERROR_SUCCESS	The function succeeds.
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. You included Connection Manager in your OS.
ERROR_NOT_SUPPORTED	This function was called from an unsupported platform.
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
WlanGetProfile
WlanDeleteProfile
WlanSetProfile
Native Wi-Fi Reference