Partager via

Méthode ISecurityInformation4 ::GetSecondarySecurity (aclui.h)

  • Article

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

Voir aussi

ISecurityInformation4