次の方法で共有

FltSetSecurityObject 関数 (fltkernel.h)

  • [アーティクル]

FltSetSecurityObject 、オブジェクトのセキュリティ状態を設定します。

構文

NTSTATUS FLTAPI FltSetSecurityObject(
  [in] PFLT_INSTANCE        Instance,
  [in] PFILE_OBJECT         FileObject,
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR SecurityDescriptor
);

パラメーター

[in] Instance

呼び出し元の不透明なインスタンス ポインター。 このパラメーターは必須であり、NULLすることはできません。

[in] FileObject

セキュリティ状態が設定されるオブジェクトのファイル オブジェクト ポインター。 呼び出し元は、SecurityInformation パラメーターの説明に示されているテーブルの [意味] 列に指定されたアクセス権を持っている必要があります。 このパラメーターは必須であり、NULLすることはできません。

[in] SecurityInformation

SECURITY_INFORMATION 次の 1 つ以上の組み合わせとして設定する情報を指定する値です。

価値 意味
OWNER_SECURITY_INFORMATION オブジェクトの所有者識別子を設定することを示します。 WRITE_OWNERアクセスが必要です。
GROUP_SECURITY_INFORMATION オブジェクトのプライマリ グループ識別子を設定することを示します。 WRITE_OWNERアクセスが必要です。
DACL_SECURITY_INFORMATION オブジェクトの随意アクセス制御リスト (DACL) を設定することを示します。 WRITE_DACアクセスが必要です。
SACL_SECURITY_INFORMATION オブジェクトのシステム ACL (SACL) を設定することを示します。 ACCESS_SYSTEM_SECURITYアクセスが必要です。

[in] SecurityDescriptor

オブジェクトに設定するセキュリティ記述子へのポインター。

戻り値

FltSetSecurityObject は、STATUS_SUCCESSまたは次のいずれかの適切な NTSTATUS 値を返します。

リターン コード 形容
STATUS_ACCESS_DENIED 呼び出し元に必要なアクセス権がありませんでした。 これはエラー コードです。
STATUS_ACCESS_VIOLATION SecurityDescriptor は、NULL ポインターでした。 これはエラー コードです。
STATUS_INSUFFICIENT_RESOURCES オブジェクトのセキュリティ記述子をキャプチャできませんでした。 これはエラー コードです。
STATUS_INVALID_ACL オブジェクトのセキュリティ記述子に無効な ACL が含まれていました。 これはエラー コードです。
STATUS_INVALID_SECURITY_DESCR SecurityDescriptor が有効なセキュリティ記述子を指していません。 これはエラー コードです。
STATUS_INVALID_SID オブジェクトのセキュリティ記述子に無効な SID が含まれていました。 これはエラー コードです。
STATUS_UNKNOWN_REVISION オブジェクトのセキュリティ記述子のリビジョン レベルが不明であるか、サポートされていませんでした。 これはエラー コードです。
STATUS_NOT_IMPLEMENTED fltSetSecurityObject ルーチン は存在しますが、呼び出されたオペレーティング システム環境ではサポートされていません。

備考

FltSetSecurityObject ルーチンが存在し、Windows Vista 以降でサポートされています。 Windows 2000、Windows XP、および Server 2003 SP1 では、ルーチンは存在しますがサポートされておらず、これらの環境のいずれかで呼び出された場合はSTATUS_NOT_IMPLEMENTEDが返されます。

セキュリティ記述子は、絶対形式でも自己相対形式でもかまいません。 自己相対形式では、構造体のすべてのメンバーが連続してメモリ内に配置されます。 絶対形式では、構造体にはメンバーへのポインターのみが含まれます。 詳細については、「セキュリティ記述子の絶対 Self-Relative」を参照してください。

セキュリティとアクセス制御の詳細については、Windows SDK のこれらのトピックに関するドキュメントを参照してください。

必要条件

要件 価値
ターゲット プラットフォーム の 万国
ヘッダー fltkernel.h (Fltkernel.h を含む)
ライブラリ FltMgr.lib
DLL Fltmgr.sys
IRQL PASSIVE_LEVEL

関連項目

SECURITY_DESCRIPTOR

SECURITY_INFORMATION

ZwQuerySecurityObject

ZwSetSecurityObject

FltQuerySecurityObject の