PRADIUS_EXTENSION_PROCESS_EX Rückruffunktion (authif.h)

Artikel
08/22/2023

Hinweis Der Internetauthentifizierungsdienst (IAS) wurde ab Windows Server 2008 in Network Policy Server (NPS) umbenannt. Der Inhalt dieses Themas gilt sowohl für IAS als auch für NPS. Im gesamten Text wird NPS verwendet, um auf alle Versionen des Diensts zu verweisen, einschließlich der ursprünglich als IAS bezeichneten Versionen.

Die RadiusExtensionProcessEx-Funktion ist eine anwendungsdefinierte Funktion und wird vom NPS für jedes Authentifizierungs- oder Abrechnungspaket aufgerufen, das NPS vom Netzwerkzugriffsserver (NAS) empfängt. Diese Funktion ähnelt RadiusExtensionProcess. RadiusExtensionProcessEx ermöglicht es der Erweiterungs-DLL jedoch, Attribute an die Authentifizierungsantwort anzufügen.

Syntax

PRADIUS_EXTENSION_PROCESS_EX PradiusExtensionProcessEx;

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

Parameter

[in] pInAttrs

Zeiger auf ein Array von Attributen aus der Anforderung. Das Array wird durch ein Attribut beendet, wobei dwAttrType auf ratMinimum festgelegt ist. Diese Attribute sollten als schreibgeschützt behandelt werden. Sie sollten nicht von RadiusExtensionProcessEx geändert werden. Außerdem sollte nach der Rückgabe von RadiusExtensionProcessExEx auf diese Attribute in keiner Weise verwiesen werden.

[out] pOutAttrs

Zeiger auf ein Array von Attributen , die von der NPS-Erweiterungs-DLL bereitgestellt werden. Das Array wird durch ein Attribut beendet, wobei dwAttrType auf ratMinimum festgelegt ist. NPS fügt diese Attribute der Authentifizierungsantwort hinzu.

Die NPS-Erweiterungs-DLL weist den Arbeitsspeicher für das Array von Attributen zu. NPS ruft RadiusExtensionFreeAttributes auf, um den vom Array von Attributen belegten Arbeitsspeicher freizugeben.

[out] pfAction

Zeiger auf einen Wert vom Typ RADIUS_ACTION, zunächst auf raContinue festgelegt. Dieser Parameter gibt die Aktion an, die NPS als Reaktion auf eine Access-Anforderung ausführen soll.

Rückgabewert

Wenn die Funktion erfolgreich ist, wird der Rückgabewert NO_ERROR.

Wenn die Funktion fehlschlägt, sollte der Rückgabewert ein geeigneter Fehlercode von WinError.h sein.

Hinweise

Wenn der Rückgabewert etwas anderes als NO_ERROR ist, verwirft NPS die Anforderung.

NPS unterstützt mehrere Erweiterungs-DLLs. NPS ruft RadiusExtensionProcessExEx für jede der in der Registrierung aufgeführten DLLs auf. Weitere Informationen finden Sie unter Einrichten der Erweiterungs-DLLs.

NPS ruft RadiusExtensionFreeAttributes auf, um den von RadiusExtensionProcessEx zurückgegebenen Array von Attributen belegten Arbeitsspeicher freizugeben. Aus diesem Grund müssen Sie beim Implementieren von RadiusExtensionProcessExEx auch RadiusExtensionFreeAttributes implementieren.

Weitere Informationen zur Verwendung dieser Funktion finden Sie unter NPS-Erweiterungsprozess.

Anforderungen


Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2008
Zielplattform	Windows
Kopfzeile	authif.h