Share via


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:

See Also

Reference

Native Wi-Fi Functions
WlanOpenHandle
WlanGetProfile
WlanRenameProfile
WlanSetProfile
Native Wi-Fi Reference