SetFileSecurityA 函式 (winbase.h)
SetFileSecurity 函式會設定檔案或目錄對象的安全性。
此函式已過時。 請改用 SetNamedSecurityInfo 函式。
語法
BOOL SetFileSecurityA(
[in] LPCSTR lpFileName,
[in] SECURITY_INFORMATION SecurityInformation,
[in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);
參數
[in] lpFileName
指定安全性設定之檔案或目錄之 Null 終止字串的指標。 請注意，套用至目錄的安全性不會由其子系繼承。
[in] SecurityInformation
指定SECURITY_INFORMATION結構，識別 pSecurityDescriptor 參數所指向之安全性描述項的內容。
[in] pSecurityDescriptor
SECURITY_DESCRIPTOR 結構的指標。
傳回值
如果函式成功，函式會傳回非零。
如果函式失敗，它會傳回零。 若要取得擴充的錯誤資訊，請呼叫 GetLastError。
備註
只有在符合下列條件時 ，SetFileSecurity 函式才會成功：
- 如果設定對象的擁有者，則呼叫 進程 必須具有WRITE_OWNER許可權，或是對象的擁有者。
- 如果正在設定物件的 任意訪問控制清單 (DACL) ，則呼叫進程必須具有WRITE_DAC許可權或對象擁有者。
- 如果 設定對象的系統訪問控制清單 (SACL) ，則必須為呼叫進程啟用SE_SECURITY_NAME許可權。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | winbase.h (包含 Windows.h) |
| 程式庫 | Advapi32.lib |
| Dll | Advapi32.dll |