Win32 API 日本語リファレンス
ホーム › NetworkManagement.NetworkPolicyServer › PRADIUS_EXTENSION_PROCESS_EX

PRADIUS_EXTENSION_PROCESS_EX

コールバック

シグネチャ

DWORD PRADIUS_EXTENSION_PROCESS_EX(
    RADIUS_ATTRIBUTE* pInAttrs,
    RADIUS_ATTRIBUTE** pOutAttrs,
    RADIUS_ACTION* pfAction
);

パラメーター

フィールド型説明
pInAttrsRADIUS_ATTRIBUTE*要求に含まれる 属性の配列へのポインターです。配列は、dwAttrType に ratMinimum が設定された属性で終端されます。これらの属性は読み取り専用として扱う必要があり、 RadiusExtensionProcessEx で変更してはなりません。また、 RadiusExtensionProcessEx が戻った後は、これらの属性を一切参照しないでください。
pOutAttrsRADIUS_ATTRIBUTE**

NPS 拡張 DLL が提供する 属性の配列へのポインターです。配列は、dwAttrType に ratMinimum が設定された属性で終端されます。NPS はこれらの属性を認証応答に追加します。

属性の配列のメモリは NPS 拡張 DLL が割り当てます。NPS は RadiusExtensionFreeAttributes を呼び出して、属性の配列が占有するメモリを解放します。

pfActionRADIUS_ACTION*RADIUS_ACTION 型の値へのポインターで、初期値は raContinue です。このパラメーターは、Access-Request に応答して NPS が実行すべきアクションを指定します。

公式ドキュメント

注意 インターネット認証サービス (IAS) は、Windows Server 2008 以降、ネットワーク ポリシー サーバー (NPS) に名称が変更されました。このトピックの内容は IAS と NPS の両方に適用されます。本文中では、元々 IAS と呼ばれていたバージョンを含め、すべてのバージョンのサービスを指すために NPS という名称を使用します。
RadiusExtensionProcessEx 関数はアプリケーション定義の関数であり、NPS がネットワーク アクセス サーバー (NAS) から受信する認証パケットまたはアカウンティング パケットごとに NPS によって呼び出されます。この関数は RadiusExtensionProcess に似ています。ただし、 RadiusExtensionProcessEx では、拡張 DLL が認証応答に属性を追加できます。

戻り値

関数が成功した場合、戻り値は NO_ERROR です。

関数が失敗した場合、戻り値は WinError.h の適切なエラー コードになります。

解説(Remarks)

戻り値が NO_ERROR 以外の場合、NPS は要求を破棄します。

NPS は複数の拡張 DLL をサポートします。NPS は、レジストリに登録されている各 DLL について RadiusExtensionProcessEx を呼び出します。詳細については、 拡張 DLL のセットアップを参照してください。

NPS は RadiusExtensionFreeAttributes を呼び出して、 RadiusExtensionProcessEx が返した属性の配列が占有するメモリを解放します。このため、 RadiusExtensionProcessEx を実装する場合は、 RadiusExtensionFreeAttributes も実装する必要があります。

この関数の使用方法の詳細については、NPS 拡張機能の処理を参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)