Méthode ISecurityInformation4 ::GetSecondarySecurity (aclui.h)
La méthode GetSecondarySecurity retourne des contextes de sécurité supplémentaires qui peuvent avoir un impact sur l’accès à la ressource.
Syntaxe
HRESULT GetSecondarySecurity(
[out] PSECURITY_OBJECT *pSecurityObjects,
[out] PULONG pSecurityObjectCount
);
Paramètres
[out] pSecurityObjects
Tableau de structures SECURITY_OBJECT qui contiennent les objets de sécurité secondaires associés aux ressources définies en cas de réussite. Le tableau appartient à l’appelant et est libéré à l’aide de la fonction LocalFree . Le membre pwszName est également libéré à l’aide de LocalFree. Si les membres cbData ou cbData2 de la structure SECURITY_OBJECT ne sont pas zéro, l’appelant doit libérer les pData ou pData2 correspondants à l’aide de LocalFree. Si l’un de ces membres est égal à zéro, les membres pData et pData2 correspondants appartiennent au gestionnaire de ressources et doivent rester valides jusqu’à ce que la fonction EditSecurity retourne
[out] pSecurityObjectCount
Nombre d’objets de sécurité dans le paramètre pSecurityObjects qui sont définis en cas de réussite.
Valeur retournée
Si la méthode réussit, elle retourne S_OK.
En cas d'échec de la méthode, retourne un code d'erreur. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.
Remarques
Un gestionnaire de ressources n’a pas besoin de retourner des objets secondaires avec le membre fWellKnown défini sur TRUE et le membre Id défini sur SECURITY_OBJECT_ID_OBJECT_SD, SECURITY_OBJECT_ID_CENTRAL_POLICY ou SECURITY_OBJECT_ID_CENTRAL_ACCESS_RULE. Les objets de sécurité avec ces ID sont fournis par l’éditeur de contrôle d’accès lors de l’appel de ComputeEffectivePermissionWithSecondarySecurity.
L’interprétation des objets de sécurité retournés est liée à l’implémentation de ComputeEffectivePermissionWithSecondarySecurity.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows 8 [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2012 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | aclui.h |