Función EapPeerGetIdentity (eapmethodpeerapis.h)
Devuelve los datos de usuario y la identidad del usuario después de llamarlos por EAPHost.
Sintaxis
DWORD EapPeerGetIdentity(
[in] DWORD dwFlags,
[in] DWORD dwSizeofConnectionData,
[in] const BYTE *pConnectionData,
[in] DWORD dwSizeofUserData,
[in] const BYTE *pUserData,
[in] HANDLE hTokenImpersonateUser,
[out] BOOL *pfInvokeUI,
[in, out] DWORD *pdwSizeOfUserDataOut,
[out] BYTE **ppUserDataOut,
[out] LPWSTR *ppwszIdentity,
[out] EAP_ERROR **ppEapError
);
Parámetros
[in] dwFlags
Combinación de marcas EAP que describen el comportamiento de la sesión de autenticación de EAP.
[in] dwSizeofConnectionData
Especifica el tamaño, en bytes, del búfer de datos de conexión proporcionado en pConnectionData.
[in] pConnectionData
Puntero a un búfer de bytes que contiene el BLOB de datos de configuración opaco.
[in] dwSizeofUserData
Especifica el tamaño, en bytes, del búfer de datos de usuario proporcionado en pUserData.
[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.
[in] hTokenImpersonateUser
Especifica un identificador para el token de suplantación del usuario que se está autenticando. Este identificador será NULL al realizar la autenticación de la máquina. Con este identificador, un método EAP puede suplantar al usuario para obtener información específica del usuario, como el nombre de usuario, el nombre de dominio y las credenciales.
[out] pfInvokeUI
Devuelve TRUE si la identidad del usuario y el blob de datos de usuario no se devuelven correctamente y el método busca recopilar la información del usuario a través del cuadro de diálogo de la interfaz de usuario.
[in, out] pdwSizeOfUserDataOut
Especifica el tamaño, en bytes, del búfer ppUserDataOut .
[out] ppUserDataOut
Puntero a un puntero a 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 al puntero a 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 |