iSecurityInformation4::GetSecondarySecurity 方法 (aclui.h)
GetSecondarySecurity 方法會傳回可能會影響資源存取權的其他安全性內容。
語法
HRESULT GetSecondarySecurity(
[out] PSECURITY_OBJECT *pSecurityObjects,
[out] PULONG pSecurityObjectCount
);
參數
[out] pSecurityObjects
SECURITY_OBJECT 結構的陣列,其中包含與成功設定的資源相關聯的次要安全性物件。 陣列是由呼叫端所擁有,並使用 LocalFree 函式釋出。 pwszName 成員也會使用 LocalFree 釋出。 如果SECURITY_OBJECT結構的 cbData 或 cbData2 成員不是零,則呼叫端必須使用 LocalFree 釋放對應的 pData 或 pData2。 如果其中一個成員為零,則對應的 pData 和 pData2 成員是由資源管理員所擁有,而且必須保持有效,直到 EditSecurity 函式傳回為止
[out] pSecurityObjectCount
pSecurityObjects 參數中設定成功的安全性物件數目。
傳回值
如果方法成功,它會 傳回S_OK。
如果方法失敗,則會傳回錯誤碼。 如需常見錯誤碼的清單,請參閱 一般 HRESULT 值。
備註
資源管理員不需要傳回 fWellKnown 成員設定為 TRUE 的次要物件,而 Id 成員設定為 SECURITY_OBJECT_ID_OBJECT_SD、SECURITY_OBJECT_ID_CENTRAL_POLICY 或 SECURITY_OBJECT_ID_CENTRAL_ACCESS_RULE。 呼叫 ComputeEffectivePermissionWithSecondarySecurity 時,訪問控制編輯器會提供具有這些標識符的安全性物件。
傳回之安全性對象的解譯會系結至 ComputeEffectivePermissionWithSecondarySecurity 的實作。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows 8 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2012 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | aclui.h |