RtlSetOwnerSecurityDescriptor, fonction (ntifs.h)

Article
02/07/2025

La routine RtlSetOwnerSecurityDescriptor définit les informations de propriétaire d’un descripteur de sécurité de format absolu. Il remplace toutes les informations de propriétaire déjà présentes dans le descripteur de sécurité.

Syntaxe

NTSYSAPI NTSTATUS RtlSetOwnerSecurityDescriptor(
  [in, out]      PSECURITY_DESCRIPTOR SecurityDescriptor,
  [in, optional] PSID                 Owner,
  [in, optional] BOOLEAN              OwnerDefaulted
);

Paramètres

[in, out] SecurityDescriptor

Pointeur vers la structure SECURITY_DESCRIPTOR dont le propriétaire doit être défini. RtlSetOwnerSecurityDescriptor remplace tout propriétaire existant par le nouveau propriétaire.

[in, optional] Owner

Pointeur vers une structure d’identificateur de sécurité (SID) pour le nouveau propriétaire principal du descripteur de sécurité. Ce pointeur, et non la structure SID elle-même, est copié dans le descripteur de sécurité. Si ce paramètre est NULL, RtlSetOwnerSecurityDescriptor efface les informations de propriétaire du descripteur de sécurité. Cela marque le descripteur de sécurité comme n’ayant aucun propriétaire.

[in, optional] OwnerDefaulted

Défini sur TRUE si les informations du propriétaire sont dérivées d’un mécanisme par défaut. Si cette valeur est TRUE, il s’agit d’informations par défaut. RtlSetOwnerSecurityDescriptor définit l’indicateur de SE_OWNER_DEFAULTED dans le champ SECURITY_DESCRIPTOR_CONTROL du descripteur de sécurité. Si ce paramètre est FALSE, l’indicateur SE_OWNER_DEFAULTED est effacé.

Valeur de retour

RtlSetOwnerSecurityDescriptor pouvez retourner l’un des codes d’état suivants :

Retourner le code	Description
STATUS_SUCCESS	Le propriétaire a été correctement défini ou réinitialisé.
STATUS_UNKNOWN_REVISION	La version du descripteur de sécurité donnée n’est pas reconnue par cette routine.
STATUS_INVALID_SECURITY_DESCR	Le descripteur de sécurité donné n’est pas un descripteur de sécurité absolu valide.

Remarques

Pour plus d’informations sur la sécurité et le contrôle d’accès, consultez modèle de sécurité Windows pour les développeurs de pilotes et la documentation sur ces rubriques dans le Kit de développement logiciel (SDK) Windows.

Exigences

Exigence	Valeur
plateforme cible	Universel
d’en-tête	ntifs.h (include Ntifs.h)
bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe (mode noyau) ; Ntdll.dll (mode utilisateur)
IRQL	< DISPATCH_LEVEL