Función EapPeerInvokeIdentityUI (eapmethodpeerapis.h)

Genera un cuadro de diálogo de interfaz de usuario interactiva personalizada para obtener información de identidad de usuario para el método EAP en el cliente.

Sintaxis

DWORD EapPeerInvokeIdentityUI(
  [in]  EAP_METHOD_TYPE *pEapType,
  [in]  DWORD           dwFlags,
  [in]  HWND            hwndParent,
  [in]  DWORD           dwSizeOfConnectionData,
  [in]  const BYTE      *pConnectionData,
  [out] DWORD           dwSizeOfUserData,
  [in]  const BYTE      *pUserData,
  [out] DWORD           *pdwSizeOfUserDataOut,
  [out] BYTE            **ppUserDataOut,
  [out] LPWSTR          *ppwszIdentity,
  [out] EAP_ERROR       **ppEapError
);

Parámetros

[in] pEapType

Estructura EAP_METHOD_TYPE que contiene información de proveedor y autor sobre el método EAP utilizado para autenticar la conexión.

[in] dwFlags

Combinación de marcas EAP que describen el comportamiento de la sesión de autenticación de EAP.

[in] hwndParent

Identificador de la ventana primaria que generará el cuadro de diálogo de la interfaz de usuario interactiva para obtener los datos de identidad.

[in] dwSizeOfConnectionData

Tamaño, en bytes, de los datos de contexto de la interfaz de usuario especificados por pUIContextData.

[in] pConnectionData

Puntero a un búfer de bytes opaco que contiene los datos de conexión.

[out] dwSizeOfUserData

Especifica el tamaño, en bytes, de los datos de identidad de usuario devueltos en dwSizeOfUserData.

[in] pUserData

Puntero a los datos de usuario específicos de esta autenticación que se usan para rellenar previamente los datos de usuario. Cuando se llama a esta API por primera vez o cuando se inicia una nueva sesión de autenticación, este parámetro es NULL. De lo contrario, establezca este parámetro en el miembro pUserData de la estructura a la que apunta el parámetro ppResult recibido por EapPeerGetResult.

[out] pdwSizeOfUserDataOut

Especifica el tamaño, en bytes, del búfer ppUserDataOut .

[out] ppUserDataOut

Puntero al puntero de los datos de usuario devueltos. Los datos se pasan a EapPeerBeginSession como entrada pUserData.

[out] ppwszIdentity

Puntero a la identidad de usuario devuelta. El puntero se incluirá en el paquete de respuesta de identidad y se devolverá al servidor.

[out] ppEapError

Puntero a la dirección de una estructura de EAP_ERROR que contiene los errores generados durante la ejecución de esta llamada de función. Después de consumir los datos de error, esta memoria debe liberarse llamando a EapPeerFreeErrorMemory.

Valor devuelto

None

Observaciones

Esta llamada se realiza mediante un EAPHost basado en el mismo nivel mediante un puntero de función a esta API. Esta API debe implementarse en el método EAP cargado por EAPHost y debe cumplir estrictamente la sintaxis y los tipos de parámetros especificados en la documentación.

Requisitos

Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	eapmethodpeerapis.h

Consulte también

Funciones de configuración del método del mismo nivel de EAPHost

EapPeerInvokeIdentityUI