FwpmFilterSetSecurityInfoByKey0 関数 (fwpmk.h)
FwpmFilterSetSecurityInfoByKey0 関数は、フィルター オブジェクトのセキュリティ記述子に指定されたセキュリティ情報を設定します。
構文
NTSTATUS FwpmFilterSetSecurityInfoByKey0(
[in] HANDLE engineHandle,
[in, optional] const GUID *key,
[in] SECURITY_INFORMATION securityInfo,
[in, optional] const SID *sidOwner,
[in, optional] const SID *sidGroup,
[in, optional] const ACL *dacl,
[in, optional] const ACL *sacl
);
パラメーター
[in] engineHandle
フィルター エンジンへの開いているセッションのハンドル。 FwpmEngineOpen0 を呼び出して、フィルター エンジンへのセッションを開きます。
[in, optional] key
フィルターの一意識別子。 この GUID は、アプリケーションがこのオブジェクトに対して fwpmFilterAdd0 を呼び出したときに、
[in] securityInfo
設定するセキュリティ情報の種類。
[in, optional] sidOwner
セキュリティ記述子に設定する所有者のセキュリティ識別子 (SID)。
[in, optional] sidGroup
セキュリティ記述子に設定するグループの SID。
[in, optional] dacl
セキュリティ記述子に設定する随意アクセス制御リスト (DACL)。
[in, optional] sacl
セキュリティ記述子に設定するシステム アクセス制御リスト (SACL)。
戻り値
| 戻りコード/値 | 形容 |
|---|---|
|
ERROR_SUCCESS 0 |
セキュリティ記述子が正常に設定されました。 |
|
FWP_E_* エラー コードの 0x80320001 — 0x80320039 |
Windows フィルタリング プラットフォーム (WFP) 固有のエラー。 詳細については、「WFP エラー コードの」を参照してください。 |
|
RPC_* エラー コードの 0x80010001 — 0x80010122 |
リモートまたはローカルのファイアウォール エンジンとの通信に失敗しました。 |
| その他の NTSTATUS コード | エラーが発生しました。 |
備考
この関数は、トランザクション内から呼び出すことはできません。FWP_E_TXN_IN_PROGRESSで失敗します。 トランザクションの詳細については、オブジェクト管理 の
この関数は、対応するオブジェクトが同じセッション中に追加された場合、動的セッション内で呼び出すことができます。 別の動的セッション中に追加されたオブジェクトに対してこの関数が呼び出されると、FWP_E_WRONG_SESSIONで失敗します。 動的セッション中に追加されなかったオブジェクトに対してこの関数が呼び出されると、FWP_E_DYNAMIC_SESSION_IN_PROGRESSで失敗します。
この関数は、標準の Win32 SetSecurityInfo 関数と同様に動作します。 呼び出し元には、SetSecurityInfo リファレンス トピックで説明されているのと同じ標準アクセス権が必要です。
必要条件
| 要件 | 価値 |
|---|---|
| サポートされる最小クライアント | Windows Vista 以降で使用できます。 |
| ターゲット プラットフォーム の |
万国 |
| ヘッダー | fwpmk.h |
| ライブラリ | fwpkclnt.lib |
| IRQL | <= PASSIVE_LEVEL |