Función RasEapInvokeInteractiveUI (raseapif.h)

Artículo
08/25/2023

El administrador de conexiones RAS llama a la función RasEapInvokeInteractiveUI para mostrar un cuadro de diálogo para obtener datos de autenticación del usuario.

Sintaxis

DWORD RasEapInvokeInteractiveUI(
  [in]  DWORD dwEapTypeId,
  [in]  HWND  hwndParent,
  [in]  BYTE  *pUIContextData,
  [in]  DWORD dwSizeOfUIContextData,
        BYTE  **ppDataFromInteractiveUI,
  [out] DWORD *pdwSizeOfDataFromInteractiveUI
);

Parámetros

[in] dwEapTypeId

Especifica el protocolo de autenticación para el que se va a invocar la interfaz de usuario interactiva.

[in] hwndParent

Identificador de la ventana primaria del cuadro de diálogo.

[in] pUIContextData

Puntero a datos de contexto para la interfaz de usuario interactiva. El protocolo de autenticación proporciona un puntero a estos datos como miembro de la estructura PPP_EAP_OUTPUT . El Administrador de conexiones RAS recibe la estructura PPP_EAP_OUTPUT como parámetro de salida de la función RasEapMakeMessage.

[in] dwSizeOfUIContextData

Especifica el tamaño de los datos de contexto. El protocolo de autenticación proporciona el tamaño como miembro de la estructura de PPP_EAP_OUTPUT . El Administrador de conexiones RAS recibe la estructura PPP_EAP_OUTPUT como parámetro de salida de la función RasEapMakeMessage.

ppDataFromInteractiveUI

[out[ Puntero a una variable de puntero. Si la devolución se realiza correctamente, esta variable de puntero apunta a un búfer de memoria que contiene los datos obtenidos por la interfaz de usuario interactiva. La interfaz de usuario interactiva asigna esta memoria. RAS vuelve a pasar estos datos al protocolo de autenticación en la estructura de PPP_EAP_INPUT y, a continuación, RAS libera esta memoria llamando a RasEapFreeMemory.

Si la interfaz de usuario interactiva no obtiene ningún dato específico del usuario, el puntero al que ppUserData apunta debe establecerse en NULL.

[out] pdwSizeOfDataFromInteractiveUI

Puntero a una variable DWORD que recibe el tamaño de los datos devueltos desde la interfaz de usuario interactiva. Si la interfaz de usuario interactiva no obtiene ningún dato específico del usuario, la variable DWORD debe establecerse en cero.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es NO_ERROR. Compruebe los parámetros ppDataFromInteractiveUI y lpdwSizeOfDataFromInteractiveUI para determinar si la función devolvió datos de la interfaz de usuario interactiva.

Si la función no pudo asignar memoria para los datos, el valor devuelto debe ser ERROR_NOT_ENOUGH_MEMORY.

Si se produce un error en la función de alguna otra manera, el valor devuelto debe ser un código de error adecuado de Winerror.h, Raserror.h o Mprerror.h.

Comentarios

El archivo DLL que implementa las funciones RasEapInvokeInteractiveUI y RasEapFreeMemory pueden admitir más de un protocolo de autenticación. El parámetro dwEapTypeId especifica el protocolo de autenticación para el que se va a invocar la interfaz de usuario interactiva.

Un puntero a los datos devueltos desde la interfaz de usuario interactiva se devuelve al protocolo de autenticación en el miembro pDataFromInteractiveUI de PPP_EAP_INPUT estructura. La estructura PPP_EAP_INPUT se pasa como parámetro a la función RasEapMakeMessage .

La interfaz de usuario interactiva debe admitir WM_COMMAND mensajes en los que LOWORD(wParam) sea igual a IDCANCEL.

Requisitos


Cliente mínimo compatible	Windows 2000 Professional [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows 2000 Server [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	raseapif.h