FwpmEngineSetSecurityInfo0 関数 (fwpmu.h)
FwpmEngineSetSecurityInfo0 関数は、フィルター エンジンのセキュリティ記述子に指定されたセキュリティ情報を設定します。
構文
DWORD FwpmEngineSetSecurityInfo0(
[in] HANDLE engineHandle,
[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
型: HANDLE
フィルター エンジンへの開いているセッションのハンドル。 FwpmEngineOpen0 を呼び出して、フィルター エンジンへのセッションを開きます。
[in] securityInfo
設定するセキュリティ情報の種類。
[in, optional] sidOwner
型: const SID*
セキュリティ記述子で設定する所有者のセキュリティ識別子 (SID)。
[in, optional] sidGroup
型: const SID*
セキュリティ記述子で設定するグループの SID。
[in, optional] dacl
型: const ACL*
セキュリティ記述子で設定する随意アクセス制御リスト (DACL)。
[in, optional] sacl
型: const ACL*
セキュリティ記述子で設定するシステム アクセス制御リスト (SACL)。
戻り値
型: DWORD
リターン コード/値 | Description |
---|---|
|
セキュリティ記述子が正常に設定されました。 |
|
Windows フィルタリング プラットフォーム (WFP) 固有のエラー。 詳細については、「 WFP エラー コード 」を参照してください。 |
|
リモートまたはローカルのファイアウォール エンジンとの通信に失敗しました。 |
注釈
FwpmEngineSetSecurityInfo0 は、トランザクション内から呼び出すことはできません。 FWP_E_TXN_IN_PROGRESSで失敗します。 トランザクションの詳細については、「 オブジェクト管理 」を参照してください。
FwpmEngineSetSecurityInfo0 は 、標準の Win32 SetSecurityInfo 関数と同様に動作します。 呼び出し元には 、SetSecurityInfo リファレンス トピックで説明されているのと同じ標準アクセス権が必要です。
FwpmEngineSetSecurityInfo0 は、FwpmEngineSetSecurityInfo の特定の実装です。 詳細については、「 WFP Version-Independent 名と特定のバージョンの Windows を対象 とする」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | Windows Vista [デスクトップ アプリのみ] |
サポートされている最小のサーバー | Windows Server 2008 [デスクトップ アプリのみ] |
対象プラットフォーム | Windows |
ヘッダー | fwpmu.h |
Library | Fwpuclnt.lib |
[DLL] | Fwpuclnt.dll |