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 |
|
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