SetFileSecurityA 函式 (winbase.h)

發行項
03/03/2024

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