Fonction RtlGetGroupSecurityDescriptor (ntifs.h)
La routine RtlGetGroupSecurityDescriptor retourne les informations du 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) pour le groupe principal. Si le descripteur de sécurité ne contient pas de groupe principal, *Groupe reçoit NULL.
[out] GroupDefaulted
Pointeur vers une variable booléenne qui reçoit la valeur de l’indicateur de SE_GROUP_DEFAULTED dans la structure SECURITY_DESCRIPTOR_CONTROL du descripteur de sécurité. Cette valeur n’est valide que si *Group reçoit une valeurNULL non.
Valeur de retour
RtlGetGroupSecurityDescriptor retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée, par exemple :
| Retourner le code | 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 vers lequel pointe groupe à l’adresse du SID du descripteur de sécurité et définit la variable pointée par GroupDefaulted à une valeur valide.
Si le descripteur de sécurité pointé par SecurityDescriptor ne contient pas de groupe principal, RtlGetGroupSecurityDescriptor définit le pointeur vers lequel pointe groupe à NULL et ignore le paramètre de sortie restant, GroupDefaulted.
Pour définir les informations de groupe principal d’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 du Kit de développement logiciel (SDK) Microsoft Windows.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows Server 2003 SP1 |
| plateforme cible | Universel |
| d’en-tête | ntifs.h (include Ntifs.h) |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | <= APC_LEVEL |