ISecurityInformation：：GetSecurity 方法 (aclui.h)
GetSecurity 方法會要求安全性描述元的安全性描述元，其安全性描述項正在編輯。 訪問控制編輯器會呼叫這個方法來擷取物件的目前或預設安全性描述元。
語法
HRESULT GetSecurity(
[in] SECURITY_INFORMATION RequestedInformation,
[out] PSECURITY_DESCRIPTOR *ppSecurityDescriptor,
[in] BOOL fDefault
);
參數
[in] RequestedInformation
一組 SECURITY_INFORMATION 位旗標，指出要求的安全性描述元部分。 此參數可以是下列值的組合。
| 值 | 意義 |
|---|---|
|
安全性描述元必須包含物件擁有者的 SID。 |
|
安全性描述項必須包含物件主要群組的 SID。 |
|
安全性描述元必須包含物件的 DACL。 |
|
安全性描述元必須包含物件的 SACL。 |
[out] ppSecurityDescriptor
實作必須設定為物件之安全性描述元指標的變數指標。 安全性描述元必須包含 RequestedInformation 參數所要求的元件。
系統會呼叫 LocalFree 函式以釋放傳回的指標。
[in] fDefault
如果此參數為TRUE，ppSecurityDescriptor 應該會傳回物件的應用程式定義預設安全性描述元。 訪問控制編輯器會使用此預設安全性描述元來重新初始化屬性頁。
只有當使用者按兩下 [預設] 按鈕時，訪問控制編輯器才會將此參數設定為TRUE。 只有在您在 ISecurityInformation：：GetObjectInformation 方法中設定 SI_RESET 旗標時，才會顯示 [預設] 按鈕。 如果沒有可用的預設安全性描述元，請勿設定SI_RESET旗標。
如果此旗標為 FALSE，ppSecurityDescriptor 應該傳回物件的目前安全性描述元。
傳回值
如果成功，則傳回S_OK。
如果發生錯誤，則傳回非零錯誤碼。 如果使用者沒有讀取要求的安全性資訊的許可權，則傳回E_ACCESSDENIED。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP [僅限傳統型應用程式] |
| 最低支援的伺服器 | Windows Server 2003 [僅限傳統型應用程式] |
| 目標平台 | Windows |
| 標頭 | aclui.h |