(securitybaseapi.h) SetFileSecurityW 函式

SetFileSecurity 函式會設定檔案或目錄對象的安全性。

此函式已過時。 請改用 SetNamedSecurityInfo 函式。

語法

BOOL SetFileSecurityW(
  [in] LPCWSTR              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
標頭	securitybaseapi.h (包含 Windows.h)
程式庫	Advapi32.lib
Dll	Advapi32.dll

另請參閱

GetFileSecurity
低階 存取控制
低階 存取控制 函式
SECURITY_DESCRIPTOR
SECURITY_INFORMATION
SetKernelObjectSecurity
SetNamedSecurityInfoSetPrivateObjectSecurity
SetUserObjectSecurity