共用方式為

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 Class

其他資源

Security Global Functions