função de retorno de chamada PRADIUS_EXTENSION_PROCESS_EX (authif.h)

Artigo
03/14/2023

Nota O IAS (Serviço de Autenticação da Internet) foi renomeado como NPS (Servidor de Política de Rede) a partir do Windows Server 2008. O conteúdo deste tópico se aplica à IAS e ao NPS. Ao longo do texto, o NPS é usado para se referir a todas as versões do serviço, incluindo as versões originalmente conhecidas como IAS.

A função RadiusExtensionProcessEx é uma função definida pelo aplicativo e é chamada pelo NPS para cada pacote de autenticação ou contabilidade que o NPS recebe do NAS (servidor de acesso à rede). Essa função é semelhante a RadiusExtensionProcess. No entanto, RadiusExtensionProcessEx permite que a DLL de Extensão acrescente atributos à resposta de autenticação.

Sintaxe

PRADIUS_EXTENSION_PROCESS_EX PradiusExtensionProcessEx;

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

Parâmetros

[in] pInAttrs

Ponteiro para uma matriz de atributos da solicitação. A matriz é encerrada por um atributo com dwAttrType definido como ratMinimum. Esses atributos devem ser tratados como somente leitura; eles não devem ser modificados por RadiusExtensionProcessEx. Além disso, esses atributos não devem ser referenciados de forma alguma após o retorno de RadiusExtensionProcessEx .

[out] pOutAttrs

Ponteiro para uma matriz de atributos fornecida pela DLL de Extensão do NPS. A matriz é encerrada por um atributo com dwAttrType definido como ratMinimum. O NPS adiciona esses atributos à resposta de autenticação.

A DLL da Extensão NPS aloca a memória para a matriz de atributos. O NPS chama RadiusExtensionFreeAttributes para liberar a memória ocupada pela matriz de atributos.

[out] pfAction

Ponteiro para um valor do tipo RADIUS_ACTION, inicialmente definido como raContinue. Esse parâmetro especifica a ação que o NPS deve tomar em resposta a uma Solicitação de Acesso.

Valor retornado

Se a função for bem-sucedida, o valor retornado será NO_ERROR.

Se a função falhar, o valor retornado deverá ser um código de erro apropriado de WinError.h.

Comentários

Se o valor retornado for diferente de NO_ERROR, o NPS descartará a solicitação.

O NPS dá suporte a várias DLLs de Extensão. O NPS chama RadiusExtensionProcessEx para cada uma das DLLs listadas no registro. Para obter mais informações, consulte Configurando as DLLs de extensão.

O NPS chama RadiusExtensionFreeAttributes para liberar a memória ocupada pela matriz de atributos retornados por RadiusExtensionProcessEx. Por esse motivo, se você implementar RadiusExtensionProcessEx, também deverá implementar RadiusExtensionFreeAttributes.

Para obter mais informações sobre o uso dessa função, consulte Processo de Extensões do NPS.

Requisitos


Cliente mínimo com suporte	Nenhum compatível
Servidor mínimo com suporte	Windows Server 2008
Plataforma de Destino	Windows
Cabeçalho	authif.h