ISecurityInformation4::GetSecondarySecurity-Methode (aclui.h)
Die GetSecondarySecurity-Methode gibt zusätzliche Sicherheitskontexte zurück, die sich auf den Zugriff auf die Ressource auswirken können.
Syntax
HRESULT GetSecondarySecurity(
[out] PSECURITY_OBJECT *pSecurityObjects,
[out] PULONG pSecurityObjectCount
);
Parameter
[out] pSecurityObjects
Ein Array von SECURITY_OBJECT Strukturen, die die sekundären Sicherheitsobjekte enthalten, die den Ressourcen zugeordnet sind, die erfolgreich festgelegt werden. Das Array gehört dem Aufrufer und wird mithilfe der LocalFree-Funktion freigegeben. Das pwszName-Element wird auch mithilfe von LocalFree freigegeben. Wenn die cbData - oder cbData2-Member der SECURITY_OBJECT-Struktur nicht 0 sind, muss der Aufrufer die entsprechenden pData - oder pData2-Elemente mithilfe von LocalFree freigeben. Wenn eines dieser Member 0 ist, sind die entsprechenden pData - und pData2-Member im Besitz des Ressourcen-Managers und müssen gültig bleiben, bis die EditSecurity-Funktion zurückgegeben wird.
[out] pSecurityObjectCount
Die Anzahl der Sicherheitsobjekte im pSecurityObjects-Parameter , die bei Erfolg festgelegt werden.
Rückgabewert
Wenn die Methode erfolgreich ist, gibt sie S_OK zurück.
Bei einem Fehler gibt diese Methode einen Fehlercode zurück. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.
Hinweise
Ein Ressourcen-Manager muss keine sekundären Objekte zurückgeben, wobei das fWellKnown-Element auf TRUE festgelegt ist und der Id-Member auf SECURITY_OBJECT_ID_OBJECT_SD, SECURITY_OBJECT_ID_CENTRAL_POLICY oder SECURITY_OBJECT_ID_CENTRAL_ACCESS_RULE festgelegt ist. Sicherheitsobjekte mit diesen IDs werden vom Zugriffssteuerungs-Editor bereitgestellt, wenn ComputeEffectivePermissionWithSecondarySecurity aufgerufen wird.
Die Interpretation der zurückgegebenen Sicherheitsobjekte ist an die Implementierung von ComputeEffectivePermissionWithSecondarySecurity gebunden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows 8 [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows Server 2012 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | aclui.h |