SetFileSecurityA 関数 (winbase.h)

[アーティクル]
08/27/2023

SetFileSecurity 関数は、ファイルまたはディレクトリオブジェクトのセキュリティを設定します。

この関数は、現在使用されていません。代わりに SetNamedSecurityInfo 関数を使用してください。

構文

BOOL SetFileSecurityA(
  [in] LPCSTR               lpFileName,
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);

パラメーター

[in] lpFileName

セキュリティが設定されているファイルまたはディレクトリを指定する null で終わる文字列へのポインター。ディレクトリに適用されるセキュリティは、その子によって継承されないことに注意してください。

[in] SecurityInformation

pSecurityDescriptor パラメーターによって指されるセキュリティ記述子の内容を識別するSECURITY_INFORMATION構造体を指定します。

[in] pSecurityDescriptor

SECURITY_DESCRIPTOR構造体へのポインター。

戻り値

関数が成功した場合、関数は 0 以外の値を返します。

関数が失敗すると、0 が返されます。詳細なエラー情報を得るには、GetLastError を呼び出します。

解説

SetFileSecurity 関数は、次の条件が満たされた場合にのみ成功します。

オブジェクトの所有者が設定されている場合、呼び出し元のプロセスには、WRITE_OWNERアクセス許可を持っているか、オブジェクトの所有者である必要があります。
オブジェクトの随意アクセス制御リスト (DACL) が設定されている場合、呼び出し元のプロセスには、WRITE_DACアクセス許可が必要です。または、オブジェクトの所有者である必要があります。
オブジェクトのシステムアクセス制御リスト (SACL) が設定されている場合は、呼び出し元プロセスに対してSE_SECURITY_NAME特権を有効にする必要があります。

要件

要件	値
サポートされている最小のクライアント	Windows XP (デスクトップアプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップアプリのみ)
対象プラットフォーム	Windows
ヘッダー	winbase.h (Windows.h を含む)
Library	Advapi32.lib
[DLL]	Advapi32.dll