Fonction SetKernelObjectSecurity (securitybaseapi.h)

Article
03/01/2024

La fonction SetKernelObjectSecurity définit la sécurité d’un objet noyau. Par exemple, il peut s’agir d’un processus, d’un thread ou d’un événement.

Note Cette fonction ne doit pas être utilisée lors de la définition d’un descripteur de sécurité sur des objets de système de fichiers. Utilisez plutôt les fonctions SetSecurityInfo ou SetNamedSecurityInfo .

Syntaxe

BOOL SetKernelObjectSecurity(
  [in] HANDLE               Handle,
  [in] SECURITY_INFORMATION SecurityInformation,
  [in] PSECURITY_DESCRIPTOR SecurityDescriptor
);

Paramètres

[in] Handle

Handle d’un objet de noyau pour lequel les informations de sécurité sont définies.

[in] SecurityInformation

Ensemble d’indicateurs de bits qui indiquent le type d’informations de sécurité à définir. Ce paramètre peut être une combinaison des indicateurs de bits SECURITY_INFORMATION .

[in] SecurityDescriptor

Pointeur vers une structure de SECURITY_DESCRIPTOR qui contient les nouvelles informations de sécurité.

Valeur retournée

Si la fonction réussit, la fonction retourne une valeur différente de zéro.

Si la fonction échoue, elle retourne 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