PRADIUS_EXTENSION_PROCESS_EX funzione di callback (authif.h)

Articolo
03/14/2023

Nota Internet Authentication Service (IAS) è stato rinominato Server dei criteri di rete (NPS) a partire da Windows Server 2008. Il contenuto di questo argomento si applica sia a IAS che a NPS. In tutto il testo, NPS viene usato per fare riferimento a tutte le versioni del servizio, incluse le versioni originariamente definite IAS.

La funzione RadiusExtensionProcessEx è una funzione definita dall'applicazione e viene chiamata da SERVER dei criteri di rete per ogni pacchetto di autenticazione o contabilità che npS riceve dal server di accesso alla rete (NAS). Questa funzione è simile a RadiusExtensionProcess. RadiusExtensionProcessEx consente tuttavia alla DLL di estensione di aggiungere attributi alla risposta di autenticazione.

Sintassi

PRADIUS_EXTENSION_PROCESS_EX PradiusExtensionProcessEx;

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

Parametri

[in] pInAttrs

Puntatore a una matrice di attributi dalla richiesta. La matrice viene terminata da un attributo con dwAttrType impostato su ratMinimum. Questi attributi devono essere considerati di sola lettura; non devono essere modificati da RadiusExtensionProcessEx. Inoltre, questi attributi non devono essere referenziati in alcun modo dopo la restituzione di RadiusExtensionProcessEx .

[out] pOutAttrs

Puntatore a una matrice di attributi forniti dalla DLL dell'estensione NPS. La matrice viene terminata da un attributo con dwAttrType impostato su ratMinimum. Nps aggiunge questi attributi alla risposta di autenticazione.

La DLL dell'estensione NPS alloca la memoria per la matrice di attributi. NPS chiama RadiusExtensionFreeAttributes per liberare la memoria occupata dalla matrice di attributi.

[out] pfAction

Puntatore a un valore di tipo RADIUS_ACTION, inizialmente impostato su raContinue. Questo parametro specifica l'azione che server dei criteri di rete deve eseguire in risposta a una richiesta di accesso.

Valore restituito

Se la funzione ha esito positivo, il valore restituito viene NO_ERROR.

Se la funzione ha esito negativo, il valore restituito deve essere un codice di errore appropriato da WinError.h.

Commenti

Se il valore restituito è diverso da NO_ERROR, Server dei criteri di rete rimuove la richiesta.

Server dei criteri di rete supporta più DLL di estensione. NPS chiama RadiusExtensionProcessEx per ognuna delle DLL elencate nel Registro di sistema. Per altre informazioni, vedere Configurazione delle DLL di estensione.

NPS chiama RadiusExtensionFreeAttributes per liberare la memoria occupata dalla matrice di attributi restituiti da RadiusExtensionProcessEx. Per questo motivo, se si implementa RadiusExtensionProcessEx, è necessario implementare radiusExtensionFreeAttributes.

Per altre informazioni sull'uso di questa funzione, vedere NpS Extensions Process.For more information on the use of this function, see NPS Extensions Process.

Requisiti


Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	authif.h