EapHostPeerInvokeIdentityUI (Compact 2013)
3/26/2014
This function is called by tunnel methods to start the identity UI of the inner methods. This function returns the identity and credentials to use in order to start the authentication.
Syntax
DWORD WINAPI EapHostPeerInvokeIdentityUI(
__in DWORD dwVersion,
__in EAP_METHOD_TYPE eapMethodType,
__in DWORD dwFlags,
__in HWND hwndParent,
__in DWORD dwSizeofConnectionData,
__in const BYTE* pConnectionData,
__in DWORD dwSizeofUserData,
__in const BYTE* pUserData,
__inout DWORD* pdwSizeofUserDataOut,
__out BYTE** ppUserDataOut,
__out LPWSTR* ppwszIdentity,
__out EAP_ERROR** ppEapError,
__inout LPVOID* ppvReserved
);
Parameters
- dwVersion
The version number of the API. Must be set to zero.
- eapMethodType
An EAP_METHOD_TYPE structure that specifies the type of EAP authentication to use for this session.
- dwFlags
A combination of EAP Method Flags that describe the EAP authentication session behavior.
- hwndParent
Handle of the parent window under which the configuration dialog will appear.
- dwSizeofConnectionData
Size of the buffer indicated by the pConnectionData parameter, in bytes.
- pConnectionData
Pointer to configuration data that is used for the EAP method.
- dwSizeofUserData
Size of the buffer indicated by the pUserData parameter, in bytes.
- pUserData
Pointer to user credential information that pertains to this authentication.
- pdwSizeofUserDataOut
Size of the buffer set to receive the user data returned by the ppUserDataOut parameter, in bytes.
- ppUserDataOut
A pointer to a pointer to a buffer that contains user data information returned by the method. After use, this memory must be freed by calling EapHostPeerFreeMemory.
- ppwszIdentity
A pointer to a NULL-terminated user identity string. After use, this memory must be freed by calling EapHostPeerFreeMemory.
- ppEapError
A pointer to a pointer to an EAP_ERROR structure that contains any errors raised during the execution of this function call. After using the error data, this memory must be freed by calling EapHostPeerFreeErrorMemory.
- ppvReserved
Reserved.