Fonction RtlGetGroupSecurityDescriptor (ntifs.h)
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 |
|---|---|
|
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 |