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	The caller does not have sufficient permissions to delete the profile. You included Connection Manager in your OS.
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