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