iSecurityInformation::SetSecurity 方法 (aclui.h)
SetSecurity 方法會提供安全性描述元,其中包含使用者想要套用至安全性實體對象的安全性資訊。 當使用者按兩下 [ 確定 ] 或 [ 套用] 時,存取控制編輯器會呼叫此方法。
語法
HRESULT SetSecurity(
[in] SECURITY_INFORMATION SecurityInformation,
[in] PSECURITY_DESCRIPTOR pSecurityDescriptor
);
參數
[in] SecurityInformation
一組SECURITY_INFORMATION位旗標,指出要設定的安全性描述元部分。 此參數可以是下列值的組合。
值 | 意義 |
---|---|
|
安全性描述項包含對象擁有者的 SID。 |
|
安全性描述項包含物件主要群組的 SID。 |
|
安全性描述項包含物件的 DACL。 |
|
安全性描述項包含物件的 SACL。 |
[in] pSecurityDescriptor
包含新安全性資訊之安全描述元的指標。 請勿假設安全性描述項採用 自我相對 形式;它可以是 絕對或自我相對。
傳回值
如果成功,則傳回S_OK。
如果發生錯誤,則傳回非零的錯誤碼。
備註
若要為物件建置完整的安全性描述元,應用程式必須將 由 SecurityInformation 參數所定義的新安全性描述元元件合併到物件現有的安全性描述元中。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2003 [僅限桌面應用程式] |
目標平台 | Windows |
標頭 | aclui.h |