AtlGetSecurityDescriptor
呼叫這個函式會擷取指定物件的安全性描述元。
重要
這個函式不能用於 Windows 執行階段執行的應用程式。
inline bool AtlGetSecurityDescriptor(
LPCTSTR pszObjectName,
SE_OBJECT_TYPE ObjectType,
CSecurityDesc * pSecurityDescriptor,
SECURITY_INFORMATION requestedInfo= OWNER_SECURITY_INFORMATION |
GROUP_SECURITY_INFORMATION | DACL_SECURITY_INFORMATION |
SACL_SECURITY_INFORMATION,
bool bRequestNeededPrivileges= true
) throw(...);
參數
pszObjectName
將指定物件的名稱來擷取安全性資訊的 NULL 結尾字串的指標。ObjectType
指定從表示 pszObjectName 參數所識別的物件之型別的 SE_OBJECT_TYPE 列舉型別的值。pSecurityDescriptor
接收要求的安全性描述元的物件。requestedInfo
一組 SECURITY_INFORMATION 表示安全性資訊的型別擷取的位元旗標。 這個參數可以是下列值的組合。bRequestNeededPrivileges
如果為 true，則函式會嘗試啟用 SE_SECURITY_NAME 權限，並在完成時還原它。
傳回值
如果成功則傳回 true，失敗則傳回 false。
備註
如果 AtlGetSecurityDescriptor 要呼叫在許多不同物件的許多次，更有效率。在呼叫函式之前一次啟用 SE_SECURITY_NAME 權限，而 bRequestNeededPrivileges 設為 false。
需求
Header: atlsecurity.h