WlanSetProfileEapUserData (Compact 2013)

3/26/2014

This function sets Extensible Authentication Protocol (EAP) user credentials for a profile on an interface.

Syntax

DWORD WlanSetProfileEapUserData(
  __in        HANDLE hClientHandle,
  __in        const GUID* pInterfaceGuid,
  __in        LPCWSTR strProfileName,
  __in        EAP_METHOD_TYPE eapType,
  __in        DWORD dwFlags,
  __in        DWORD dwEapUserDataSize,
  __in_bcount(dwEapUserDataSize)  const LPBYTE pbEapUserData,
  __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.

• strProfileName
  [in] Name of the profile associated with the EAP user data. Profile names are case sensitive and the string must be NULL terminated.

• eapType
  [in] An EAP_METHOD_TYPE structure that contains the method for which the caller is supplying EAP user credentials.

• dwFlags
  [in] Reserved; set to 0 (zero).

• dwEapUserDataSize
  [in] Size, in bytes, of the data pointed to by pbEapUserData.

• pbEapUserData
  [in] Pointer to the raw EAP data that is used to set the user credentials.

• pReserved
  Reserved; set to NULL.

Return Values

Value	Description
ERROR_SUCCESS	The function succeeds.
ERROR_ACCESS_DENIED	You included Connection Manager in your OS.
ERROR_INVALID_PARAMETER	hClientHandle is NULL or invalid, pInterfaceGuid is NULL, pReserved is not NULL, strProfileName is NULL, or pbEapUserData is NULL.
ERROR_INVALID_HANDLE	The handle hClientHandle was not found in the handle table.
ERROR_NOT_SUPPORTED	This function was called from an unsupported platform.
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.

These credentials can be used only by the caller.

See Also

Reference

Native Wi-Fi Functions
WlanOpenHandle
EAP_METHOD_TYPE
WlanSetProfileEapXmlUserData
Native Wi-Fi Reference