TwclWiFiProfilesManager.SetProfileEapUserData(TGUID,string,Boolean,TwclWiFiEapMethodType,PByte,Cardinal) Method

The function sets the Extensible Authentication Protocol (EAP) user credentials as specified by raw EAP data.

Namespace: wclWiFi
Delphi
public
 function SetProfileEapUserData(const IfaceId: TGUID;
 const ProfileName: string; const AllUsers: Boolean;
 const EapMethod: TwclWiFiEapMethodType; const Data: PByte;
 const Size: Cardinal): Integer;

Parameters

IfaceId
Type: TGUID

The ID of the interface.

ProfileName
Type: string

The name of the profile associated with the EAP user data. Profile names are case-sensitive.

Windows XP with SP3 and Wireless LAN API for Windows XP with SP2: The supplied name must match the profile name derived automatically from the SSID of the network. For an infrastructure network profile, the SSID must be supplied for the profile name. For an ad hoc network profile, the supplied name must be the SSID of the ad hoc network followed by -adhoc.

AllUsers
Type: Boolean

If this parameter is True on Windows 7, Windows Server 2008 R2, and later, the EAP host data will be set for all users of this profile.

EapMethod
Type: TwclWiFiEapMethodType

An TwclWiFiEapMethodType structure that contains the method for which the caller is supplying EAP user credentials.

Data
Type: PByte

A pointer to the raw EAP data used to set the user credentials.

On Windows Vista and Windows Server 2008, this parameter must not be nil.

On Windows 7, Windows Server 2008 R2, and later, this parameter can be set to nil to delete the stored credentials for this profile if the AllUsers parameter contains set to True and the Size parameter is 0.

Size
Type: Cardinal

The size, in bytes, of the data pointed to by Data.

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.