Función EapHostPeerQueryUserBlobFromCredentialInputFields (eaphostpeerconfigapis.h)
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 |