Función EapHostPeerQueryUserBlobFromCredentialInputFields (eaphostpeerconfigapis.h)

  • Artículo

La función EapHostPeerQueryUserBlobFromCredentialInputFields obtiene un BLOB de credenciales que se puede usar para iniciar la autenticación desde la entrada del usuario recibida desde la interfaz de usuario de inicio de sesión único (SSO).

Sintaxis

DWORD EapHostPeerQueryUserBlobFromCredentialInputFields(
  [in]      HANDLE                             hUserImpersonationToken,
  [in]      EAP_METHOD_TYPE                    eapMethodType,
  [in]      DWORD                              dwFlags,
  [in]      DWORD                              dwEapConnDataSize,
  [in]      const BYTE                         *pbEapConnData,
  [in]      const EAP_CONFIG_INPUT_FIELD_ARRAY *pEapConfigInputFieldArray,
  [in, out] DWORD                              *pdwUserBlobSize,
  [in, out] BYTE                               **ppbUserBlob,
  [out]     EAP_ERROR                          **ppEapError
);

Parámetros

[in] hUserImpersonationToken

Identificador del token de suplantación de usuario que se va a usar en esta sesión.

[in] eapMethodType

Estructura EAP_METHOD_TYPE que especifica el tipo de autenticación EAP que se va a usar para esta sesió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, en bytes, del búfer de datos de conexión proporcionado en pConnectionData.

[in] pbEapConnData

Datos de conexión usados para el método EAP.

[in] pEapConfigInputFieldArray

Puntero a una estructura de EAP_CONFIG_INPUT_FIELD_ARRAY que contiene los datos del campo de entrada de la interfaz de usuario. El llamador debe liberar los punteros internos mediante la función EapHostPeerFreeMemory, comenzando en el puntero más interno.

[in, out] pdwUserBlobSize

Puntero a un DWORD que especifica el tamaño, en bytes, del búfer al que apunta ppbUserBlob. Si este valor no se establece en cero, se debe proporcionar un puntero a un búfer del tamaño especificado en este parámetro a ppbUserBlob.

[in, out] ppbUserBlob

Puntero al BLOB de credenciales que se puede usar en la autenticación. La memoria debe liberarse llamando a EapHostPeerFreeMemory. Si se proporciona un valor distinto de NULL para este parámetro (lo que significa que se le pasa un BLOB de datos existente), el BLOB de datos proporcionado se actualizará y devolverá en este parámetro. Si se proporciona un valor BLOB distinto de NULL, se debe usar la función LocalAlloc .

[out] ppEapError

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

Valor devuelto

Ninguno

Observaciones

EapHostPeerQueryUserBlobFromCredentialInputFields admite el inicio de sesión único. Esta función supplicante, como EapHostPeerQueryCredentialInputFields, solo se usa en un escenario de SSO.

Después de EapHostPeerQueryUserBlobFromCredentialInputFields, EAPHost llama a EapHostPeerBeginSession. El supplicante usa la marca EAP_FLAG_PRE_LOGON en EapHostPeerBeginSession para indicar que EAPHost debe proporcionar el inicio de sesión único.

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 eaphostpeerconfigapis.h
Library Eappcfg.lib
Archivo DLL Eappcfg.dll

Consulte también

Funciones de configuración de EAPHost Supplicant

SSO y PLAP