Partager via

EapHostPeerInvokeIdentityUI (Compact 7)

  • Article

3/12/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.

See Also

Reference

EAPHost Supplicant Configuration Functions