PRADIUS_EXTENSION_PROCESS_EX回呼函式 (authif.h)

發行項
08/22/2023

注意從 Windows Server 2008 開始，網際網路驗證服務 (IAS) 已重新命名為網路原則伺服器 (NPS) 。本主題的內容適用于 IAS 和 NPS。在整個文字中，NPS 是用來參考服務的所有版本，包括原本稱為 IAS 的版本。

RadiusExtensionProcessEx函式是應用程式定義的函式，由 NPS 針對 NPS 從網路存取伺服器接收的每個驗證或會計封包呼叫， (NAS) 。此函式類似于 RadiusExtensionProcess。不過， RadiusExtensionProcessEx 可讓延伸模組 DLL 將屬性附加至驗證回應。

語法

PRADIUS_EXTENSION_PROCESS_EX PradiusExtensionProcessEx;

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

參數

[in] pInAttrs

要求中屬性陣列的指標。陣列會由 dwAttrType 設定為 ratMinimum的屬性終止。這些屬性應視為唯讀; RadiusExtensionProcessEx不應修改它們。此外， 在 RadiusExtensionProcessEx 傳回之後，不應該以任何方式參考這些屬性。

[out] pOutAttrs

NPS 擴充功能 DLL 提供之屬性陣列的指標。陣列會由 dwAttrType 設定為 ratMinimum的屬性終止。 NPS 會將這些屬性新增至驗證回應。

NPS 延伸模組 DLL 會配置屬性陣列的記憶體。 NPS 會呼叫 RadiusExtensionFreeAttributes 來釋放屬性陣列所佔用的記憶體。

[out] pfAction

類型為 RADIUS_ACTION的指標，一開始設定為 raContinue。此參數會指定 NPS 應採取的動作，以回應 Access-Request。

傳回值

如果函式成功，傳回值 會NO_ERROR。

如果函式失敗，傳回值應該是來自 WinError.h 的適當錯誤碼。

備註

如果傳回值不是 NO_ERROR值，NPS 會捨棄要求。

NPS 支援多個延伸模組 DLL。 NPS 會針對登錄中列出的每個 DLL 呼叫 RadiusExtensionProcessEx 。如需詳細資訊，請參閱設定擴充功能 DLL。

NPS 會呼叫 RadiusExtensionFreeAttributes 來釋放 RadiusExtensionProcessEx所傳回屬性陣列所佔用的記憶體。基於這個理由，如果您實作 RadiusExtensionProcessEx，您也必須實 作 RadiusExtensionFreeAttributes。

如需使用此函式的詳細資訊，請參閱 NPS 延伸模組程式。