EapHostPeerInvokeConfigUI function

Starts the configuration user interface of the specified EAP method.

EapHostPeerInvokeConfigUI must be called on threads that have COM initialized for Single Threaded Apartment (STA). This can be achieved by calling COM API CoInitialize; when the supplicant has finished with the STA thread CoUninitialize must be called before exiting.


DWORD WINAPI EapHostPeerInvokeConfigUI(
  _In_        HWND            hwndParent,
  _In_        DWORD           dwFlags,
  _In_        EAP_METHOD_TYPE eapMethodType,
  _In_        DWORD           dwSizeOfConfigIn,
  _In_  const BYTE            *pConfigIn,
  _Out_       DWORD           *pdwSizeOfConfigOut,
  _Out_       BYTE            **ppConfigOut,
  _Out_       EAP_ERROR       **pEapError


hwndParent [in]

The handle of the parent window under which configuration dialog appears.

dwFlags [in]

A combination of EAP flags that describe the EAP authentication session behavior.

eapMethodType [in]

An EAP_METHOD_TYPE structure that specifies the EAP method.

dwSizeOfConfigIn [in]

The size of input configuration. May be set to 0 (zero).

pConfigIn [in]

A pointer to a byte buffer that contains configuration elements. The buffer is of size dwSizeOfConfigIn. This parameter can be NULL, if dwSizeOfConfigIn is set to 0 (zero).

pdwSizeOfConfigOut [out]

A pointer to a DWORD that specifies the size of the buffer pointed to by ppConfigOut.

ppConfigOut [out]

A pointer to a pointer to a byte buffer that contains updated configuration data from the user. After consuming the data, this memory must be freed by calling EapHostPeerFreeMemory.

pEapError [out]

A pointer to a pointer to an EAP_ERROR structure that contains any errors raised by EAPHost during the execution of this function call. After consuming the error data, this memory must be freed by calling EapHostPeerFreeErrorMemory.


Minimum supported client

Windows Vista [desktop apps only]

Minimum supported server

Windows Server 2008 [desktop apps only]







See also

EAPHost Supplicant Configuration Functions



Community Additions

© 2016 Microsoft