Función EapPeerGetUIContext (eapmethodpeerapis.h)
Obtiene el contexto de la interfaz de usuario del método EAP. Esta función siempre va seguida de la función EapPeerInvokeInteractiveUI , seguida de la función EapPeerSetUIContext .
Sintaxis
DWORD EapPeerGetUIContext(
[in] EAP_SESSION_HANDLE sessionHandle,
[out] DWORD *pdwSizeOfUIContextData,
[out] BYTE **ppUIContextData,
[out] EAP_ERROR **ppEapError
);
Parámetros
[in] sessionHandle
Puntero a una estructura de EAP_SESSION_HANDLE que contiene el identificador único de esta sesión de autenticación de EAP en el servidor EAPHost. Este identificador se devuelve en el parámetro pSessionHandle en una llamada anterior a EapPeerBeginSession.
[out] pdwSizeOfUIContextData
Puntero a un valor que especifica el tamaño del búfer de bytes de datos de contexto de la interfaz de usuario devuelto en ppUIContextData.
[out] ppUIContextData
Puntero a una dirección que contiene un búfer de bytes con los datos de contexto de la interfaz de usuario supplicant de EAPHost.
[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
EAPHost llama a EapPeerGetUIContext cuando una llamada anterior indica que hay disponible un contexto de interfaz de usuario.
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
| 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 |