共用方式為

AtlSetSacl

  • 發行項

呼叫這個函式會將指定物件的系統存取控制清單 (SACL) (SACL) 資訊。

重要事項重要事項

這個函式不能用於 Windows 執行階段執行的應用程式。

 
inline bool AtlSetSacl(
HANDLE hObject,
SE_OBJECT_TYPE ObjectType,
const CSacl& rSacl,
DWORD dwInheritanceFlowControl= 0,
bool bRequestNeededPrivileges= true
) throw(...);

參數

  • hObject
    物件的控制代碼可以設定安全性資訊。

  • ObjectType
    指定從表示 hObject 參數所識別的物件之型別的 SE_OBJECT_TYPE 列舉型別的值。

  • rSacl
    包含新的安全性資訊的 SACL。

  • dwInheritanceFlowControl
    繼承的控制流程。這個值可以是 0 (預設值)， PROTECTED_SACL_SECURITY_INFORMATION 或 UNPROTECTED_SACL_SECURITY_INFORMATION。

  • bRequestNeededPrivileges
    如果為 true，則函式會嘗試啟用 SE_SECURITY_NAME 權限，並在完成時還原它。

傳回值

如果成功則傳回 true，失敗則傳回 false。

備註

在偵錯組建中，判斷提示將會發生錯誤，則 hObject 無效，或者，如果 dwInheritanceFlowControl 則有三個允許的其中一個值。

如果 AtlSetSacl 要呼叫在許多不同物件的許多次，更有效率。在呼叫函式之前一次啟用 SE_SECURITY_NAME 權限，而 bRequestNeededPrivileges 設為 false。

需求

Header: atlsecurity.h

請參閱

參考

AtlGetSacl

CSacl 類別

其他資源

安全性全域函式