SetSecurityDescriptorGroup, fonction (securitybaseapi.h)

Article
03/01/2024

La fonction SetSecurityDescriptorGroup définit les informations de groupe principal d’un descripteur de sécurité au format absolu, en remplaçant toutes les informations de groupe primaire déjà présentes dans le descripteur de sécurité.

Syntaxe

BOOL SetSecurityDescriptorGroup(
  [in, out]      PSECURITY_DESCRIPTOR pSecurityDescriptor,
  [in, optional] PSID                 pGroup,
  [in]           BOOL                 bGroupDefaulted
);

Paramètres

[in, out] pSecurityDescriptor

Pointeur vers la structure SECURITY_DESCRIPTOR dont le groupe principal est défini par cette fonction. La fonction remplace tout groupe principal existant par le nouveau groupe principal.

[in, optional] pGroup

Pointeur vers une structure SID pour le nouveau groupe principal du descripteur de sécurité. La structure SID est référencée par le descripteur de sécurité, et non copié dans. Si ce paramètre a la valeur NULL, la fonction efface les informations du groupe principal du descripteur de sécurité. Cela marque le descripteur de sécurité comme n’ayant aucun groupe principal.

[in] bGroupDefaulted

Indique si les informations du groupe principal ont été dérivées d’un mécanisme par défaut. Si cette valeur a la valeur TRUE, il s’agit d’informations par défaut et la fonction stocke cette valeur en tant qu’indicateur SE_GROUP_DEFAULTED dans la structure SECURITY_DESCRIPTOR_CONTROL . Si ce paramètre est égal à zéro, l’indicateur SE_GROUP_DEFAULTED est effacé.

Valeur retournée

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau \| applications UWP]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau \| applications UWP]
Plateforme cible	Windows
En-tête	securitybaseapi.h (inclure Windows.h)
Bibliothèque	Advapi32.lib
DLL	Advapi32.dll