EapHostPeerInvokeConfigUI (Compact 2013)
3/26/2014
This function initiates 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.
Syntax
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
);
Parameters
- hwndParent
The handle of the parent window under which configuration dialog appears.
- dwFlags
A combination of EAP Method Flags that describe the EAP authentication session behavior.
- eapMethodType
An EAP_METHOD_TYPE structure that specifies the EAP method.
- dwSizeOfConfigIn
The size of input configuration. Might be set to 0 (zero).
- pConfigIn
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
A pointer to a DWORD that specifies the size of the buffer pointed to by ppConfigOut.
- ppConfigOut
A pointer to a pointer to a byte buffer that contains updated configuration data from the user. After using the data, this memory must be freed by calling EapHostPeerFreeMemory.
- pEapError
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 using the error data, this memory must be freed by calling EapHostPeerFreeErrorMemory.