TwclWiFiProfilesManager.SetProfile(TGUID,TwclWiFiProfileFlags,string,Boolean) Method

The method sets the content of a specific profile.

Namespace: wclWiFi
Delphi
public
 function SetProfile(const IfaceId: TGUID; const Flags: TwclWiFiProfileFlags;
 const ProfileXml: string; const Overwrite: Boolean): Integer;

Parameters

IfaceId
Type: TGUID

The ID of the interface.

Flags
Type: TwclWiFiProfileFlags

The flags to set on the profile.

ProfileXml
Type: string

Contains the XML representation of the profile. The WLANProfile element is the root profile element.

Overwrite
Type: Boolean

Specifies whether this profile is overwriting an existing profile. If this parameter is False and the profile already exists, the existing profile will not be overwritten and an error will be returned.

Return Value

Type: Integer

If the function succeeds, the return value is wclErrors.WCL_E_SUCCESS. If the function fails, the return value may be one of the WCL return codes.

The SetProfile method can be used to add a new wireless LAN profile or replace an existing wireless LAN profile.

A new profile is added at the top of the list after the group policy profiles. A profile's position in the list is not changed if an existing profile is overwritten.