Fonction RtlGetGroupSecurityDescriptor (ntifs.h)

  • Article

La routine RtlGetGroupSecurityDescriptor retourne les informations de groupe principal pour un descripteur de sécurité donné.

Syntaxe

NTSYSAPI NTSTATUS RtlGetGroupSecurityDescriptor(
  [in]  PSECURITY_DESCRIPTOR SecurityDescriptor,
  [out] PSID                 *Group,
  [out] PBOOLEAN             GroupDefaulted
);

Paramètres

[in] SecurityDescriptor

Pointeur vers le descripteur de sécurité dont les informations de groupe principal doivent être retournées.

[out] Group

Pointeur vers une variable qui reçoit un pointeur vers l’identificateur de sécurité (SID) du groupe principal. Si le descripteur de sécurité ne contient pas de groupe principal, *Group reçoit NULL.

[out] GroupDefaulted

Pointeur vers une variable booléenne qui reçoit la valeur de l’indicateur SE_GROUP_DEFAULTED dans la structure SECURITY_DESCRIPTOR_CONTROL du descripteur de sécurité. Cette valeur est valide uniquement si *Group reçoit une valeur non NULL .

Valeur retournée

RtlGetGroupSecurityDescriptor retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée, par exemple :

Code de retour Description
STATUS_UNKNOWN_REVISION
 Le niveau de révision du descripteur de sécurité n’est pas connu ou n’est pas pris en charge. Il s’agit d’un code d’erreur.

Remarques

Si le descripteur de sécurité pointé par SecurityDescriptor contient un groupe principal, RtlGetGroupSecurityDescriptor définit le pointeur pointé par Group vers l’adresse du SID de groupe du descripteur de sécurité et définit la variable pointée par GroupDefaulted sur une valeur valide.

Si le descripteur de sécurité pointé vers par SecurityDescriptor ne contient pas de groupe principal, RtlGetGroupSecurityDescriptor définit le pointeur pointé par Group sur NULL et ignore le paramètre de sortie restant, GroupDefaulted.

Pour définir les informations de groupe principal pour un descripteur de sécurité, utilisez RtlSetGroupSecurityDescriptor.

Pour récupérer les informations de propriétaire d’un descripteur de sécurité, utilisez RtlGetOwnerSecurityDescriptor.

Pour plus d’informations sur la sécurité et le contrôle d’accès, consultez la documentation Microsoft Windows SDK.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows Server 2003 SP1
Plateforme cible Universal
En-tête ntifs.h (inclure Ntifs.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Voir aussi

RtlGetOwnerSecurityDescriptor

RtlSetGroupSecurityDescriptor

SECURITY_DESCRIPTOR

SID