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