WlanDeleteProfile (Compact 7)
3/12/2014
This function deletes a profile from an interface or from the computer.
Syntax
DWORD WINAPI WlanDeleteProfile(
__in HANDLE hClientHandle,
__in const GUID* pInterfaceGuid,
__in LPCWSTR strProfileName,
__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 to delete the profile from.
- strProfileName
[in] Contains name of the profile to be deleted. Profile names are case-sensitive. This string must be NULL-terminated.
- pReserved
Reserved; set to NULL.
Return Values
| Value | Description |
|---|---|
ERROR_SUCCESS |
The function succeeds. |
ERROR_INVALID_PARAMETER |
hClientHandle is NULL or invalid, pInterfaceGuid is NULL, strProfileName 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 strProfileName was not found in the profile store. |
ERROR_ACCESS_DENIED |
|
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
WlanRenameProfile
WlanSetProfile
Native Wi-Fi Reference