Función RasEapInvokeConfigUI (raseapif.h)

Artículo
08/25/2023

El administrador de conexiones RAS llama a la función RasEapInvokeConfigUI para mostrar un cuadro de diálogo para obtener información de configuración del usuario. RAS llama a RasEapInvokeConfigUI cuando se crea una nueva entrada de libreta de teléfonos o se edita una entrada de libreta de teléfono existente, siempre que el protocolo de autenticación de la entrada proporcione una interfaz de usuario de configuración.

Sintaxis

DWORD RasEapInvokeConfigUI(
  [in]  DWORD dwEapTypeId,
  [in]  HWND  hwndParent,
  [in]  DWORD dwFlags,
  [in]  BYTE  *pConnectionDataIn,
  [in]  DWORD dwSizeOfConnectionDataIn,
  [out] BYTE  **ppConnectionDataOut,
  [out] DWORD *pdwSizeOfConnectionDataOut
);

Parámetros

[in] dwEapTypeId

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

[in] hwndParent

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

[in] dwFlags

Especifica cero o más de las marcas siguientes que califican el proceso de autenticación.

Marca	Significado
RAS_EAP_FLAG_ROUTER	Especifica que el equipo que está marcando es un enrutador. La ausencia de esta marca indica que el equipo que marca es un cliente RAS.
RAS_EAP_FLAG_8021X_AUTH	Especifica que esta sesión se está ejecutando en un contexto inalámbrico.
RAS_EAP_FLAG_GUEST_ACCESS	Se especifica si el cliente quiere el acceso de invitado. Esta marca se usa normalmente en el caso de una conexión inalámbrica de modo que si se produce un error en la autenticación para N número de intentos consecutivos, si está configurado para solicitar acceso de invitado, lo hace pasando esta marca. El servidor RADIUS debe configurarse para permitir el acceso de invitado.

[in] pConnectionDataIn

Puntero a los datos de conexión almacenados actualmente en la entrada de la libreta de teléfonos. Si la entrada de la libreta de teléfonos no contiene ningún dato, este parámetro es NULL.

[in] dwSizeOfConnectionDataIn

Especifica el tamaño de los datos de conexión almacenados actualmente en la entrada de la libreta de teléfonos. Si la entrada de la libreta de teléfonos de esta conexión no contiene ningún dato, este parámetro es cero.

[out] ppConnectionDataOut

Puntero a un puntero que, al devolverse correctamente, apunta a los nuevos datos de conexión que se almacenarán en la entrada de la libreta de teléfonos. Ninguno de estos datos debe ser específico de la máquina actual; las entradas de la libreta telefónica deben ser portátiles de la máquina a la máquina.

[out] pdwSizeOfConnectionDataOut

Puntero a un DWORD que recibe el tamaño de los nuevos datos de conexión que se almacenarán en la entrada de la libreta de teléfonos.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es NO_ERROR.

Si la función no pudo asignar memoria para los datos de configuración, 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 RasEapInvokeConfigUI y RasEapFreeMemory pueden admitir más de un protocolo de autenticación. El parámetro dwEapTypeId especifica para qué protocolo se va a invocar la interfaz de usuario de configuración.

RAS almacena los datos de conexión devueltos por RasEapInvokeConfigUI en la entrada de la libreta de teléfonos para la conexión en el equipo cliente.

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