SetFileSecurityA 関数 (winbase.h)
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 |