Función RasEapInvokeConfigUI (raseapif.h)

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

Controlar en 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.

Bandera	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, el cliente inalámbrico, 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 para 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 libreta de teléfono deben ser portátiles desde 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 van a almacenar 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.

Observaciones

El archivo DLL que implementa rasEapInvokeConfigUI y RasEapFreeMemory puede admitir más de un protocolo de autenticación. El parámetro dwEapTypeId especifica para qué protocolo 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

Requisito	Valor
cliente mínimo admitido	Windows 2000 Professional [solo aplicaciones de escritorio]
servidor mínimo admitido	Windows 2000 Server [solo aplicaciones de escritorio]
de la plataforma de destino de	Windows
encabezado de	raseapif.h

Consulte también

de interfaz de usuario de configuración deClient-Side

funciones de EAP

referencia de protocolo de autenticación extensible

RasEapFreeMemory

RasEapGetIdentity

RasEapInvokeInteractiveUI