SetSecurityDescriptorControl, fonction (securitybaseapi.h)

Article
08/25/2023

La fonction SetSecurityDescriptorControl définit les bits de contrôle d’un descripteur de sécurité. La fonction peut définir uniquement les bits de contrôle qui se rapportent à l’héritage automatique des AE. Pour définir les autres bits de contrôle d’un descripteur de sécurité, utilisez les fonctions, telles que SetSecurityDescriptorDacl, pour modifier les composants d’un descripteur de sécurité.

Syntaxe

BOOL SetSecurityDescriptorControl(
  [in] PSECURITY_DESCRIPTOR        pSecurityDescriptor,
  [in] SECURITY_DESCRIPTOR_CONTROL ControlBitsOfInterest,
  [in] SECURITY_DESCRIPTOR_CONTROL ControlBitsToSet
);

Paramètres

[in] pSecurityDescriptor

Pointeur vers une structure SECURITY_DESCRIPTOR dont les informations de contrôle et de révision sont définies.

[in] ControlBitsOfInterest

Masque SECURITY_DESCRIPTOR_CONTROL qui indique les bits de contrôle à définir.

[in] ControlBitsToSet

Masque SECURITY_DESCRIPTOR_CONTROL qui indique les nouvelles valeurs des bits de contrôle spécifiés par le masque ControlBitsOfInterest .

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.

Notes

La fonction SetSecurityDescriptorControl spécifie le ou les bits de contrôle à modifier, et indique si les bits sont activés ou désactivés.

Exemples

L’exemple suivant marque le DACL sur le descripteur de sécurité comme protégé.

    SetSecurityDescriptorControl( &SecDesc,
            SE_DACL_PROTECTED, SE_DACL_PROTECTED );

L’exemple suivant marque le DACL comme non protégé.

    SetSecurityDescriptorControl( &SecDesc,
            SE_DACL_PROTECTED, 0 );

Spécifications


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