PRADIUS_EXTENSION_PROCESS_EX función de devolución de llamada (authif.h)

Artículo
08/22/2023

Nota A partir de Windows Server 2008, se cambió el nombre del servicio de autenticación de Internet (IAS). El contenido de este tema se aplica tanto a IAS como a NPS. A lo largo del texto, NPS se usa para hacer referencia a todas las versiones del servicio, incluidas las versiones a las que se hace referencia originalmente como IAS.

La función RadiusExtensionProcessEx es una función definida por la aplicación y npS llama a ella para cada paquete de autenticación o contabilidad que NPS recibe del servidor de acceso a la red (NAS). Esta función es similar a RadiusExtensionProcess. Sin embargo, RadiusExtensionProcessEx permite que el archivo DLL de extensión anexe atributos a la respuesta de autenticación.

Sintaxis

PRADIUS_EXTENSION_PROCESS_EX PradiusExtensionProcessEx;

DWORD PradiusExtensionProcessEx(
  [in]  const RADIUS_ATTRIBUTE *pInAttrs,
  [out] PRADIUS_ATTRIBUTE *pOutAttrs,
  [out] PRADIUS_ACTION pfAction
)
{...}

Parámetros

[in] pInAttrs

Puntero a una matriz de atributos de la solicitud. Un atributo con dwAttrType establecido en ratMinimum finaliza la matriz. Estos atributos deben tratarse como de solo lectura; RadiusExtensionProcessEx no debe modificarlos. Además, estos atributos no se deben hacer referencia de ninguna manera después de que RadiusExtensionProcessEx devuelva.

[out] pOutAttrs

Puntero a una matriz de atributos proporcionados por el archivo DLL de extensión NPS. Un atributo con dwAttrType establecido en ratMinimum finaliza la matriz. NPS agrega estos atributos a la respuesta de autenticación.

El archivo DLL de extensión NPS asigna la memoria para la matriz de atributos. NPS llama a RadiusExtensionFreeAttributes para liberar la memoria ocupada por la matriz de atributos.

[out] pfAction

Puntero a un valor de tipo RADIUS_ACTION, establecido inicialmente en raContinue. Este parámetro especifica la acción que NPS debe realizar en respuesta a una solicitud de acceso.

Valor devuelto

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

Si se produce un error en la función, el valor devuelto debe ser un código de error adecuado de WinError.h.

Comentarios

Si el valor devuelto es distinto de NO_ERROR, NPS descarta la solicitud.

NPS admite varios archivos DLL de extensión. NPS llama a RadiusExtensionProcessEx para cada uno de los archivos DLL enumerados en el registro. Para obtener más información, consulte Configuración de los archivos DLL de extensión.

NPS llama a RadiusExtensionFreeAttributes para liberar la memoria ocupada por la matriz de atributos devueltos por RadiusExtensionProcessEx. Por este motivo, si implementa RadiusExtensionProcessEx, también debe implementar RadiusExtensionFreeAttributes.

Para obtener más información sobre el uso de esta función, consulte Proceso de extensiones NPS.

Requisitos


Cliente mínimo compatible	No se admite ninguno
Servidor mínimo compatible	Windows Server 2008
Plataforma de destino	Windows
Encabezado	authif.h