Función EapPeerQueryCredentialInputFields (eapmethodpeerapis.h)

  • Artículo

Define la implementación de una función específica del método EAP que obtiene los campos de entrada de credenciales de inicio de sesión único (SSO) de EAP para un método EAP.

Sintaxis

DWORD EapPeerQueryCredentialInputFields(
  [in]  HANDLE                       hUserImpersonationToken,
  [in]  EAP_METHOD_TYPE              eapMethodType,
  [in]  DWORD                        dwFlags,
  [in]  DWORD                        dwEapConnDataSize,
  [in]  BYTE                         *pbEapConnData,
  [out] EAP_CONFIG_INPUT_FIELD_ARRAY *pEapConfigFieldsArray,
  [out] EAP_ERROR                    **ppEapError
);

Parámetros

[in] hUserImpersonationToken

Un token de suplantación para el usuario cuyas credenciales se van a solicitar y obtener.

[in] eapMethodType

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] dwEapConnDataSize

Tamaño de los datos de bytes de configuración de SSO de EAP a los que apunta pbEapConnData, en bytes.

[in] pbEapConnData

Puntero a un búfer de bytes opaco que contiene el BLOB de datos de configuración de EAP.

[out] pEapConfigFieldsArray

Puntero a una estructura de EAP_CONFIG_INPUT_FIELD_ARRAY que contiene los campos de entrada que se van a mostrar al usuario suplicante. Los campos pwszData de los elementos EAP_CONFIG_INPUT_FIELD_DATA individuales se inicializan en NULL.

[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 pasando un puntero a los datos de error a EapPeerFreeErrorMemory.

Valor devuelto

None

Observaciones

EapPeerQueryCredentialInputFields admite el inicio de sesión único. Esta función de método del mismo nivel, como EapPeerQueryUserBlobFromCredentialInputFields, solo se usa en un escenario de SSO.

EAPHost llama a la implementación específica del método EAPhost cada vez que una aplicación supplicante llama a EapHostPeerQueryCredentialInputFields. El implementador de esta función es responsable de asegurarse de que el EAP_CONFIG_INPUT_FIELD_ARRAY devuelto por esta función contiene definiciones de campo de entrada para cada dato de credenciales que los métodos EAP solicitarán del usuario suplicante.

Requisitos

Requisito Value
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

EAP_CONFIG_INPUT_FIELD_ARRAY

SSO y PLAP