Fonction RtlSetOwnerSecurityDescriptor (ntifs.h)

Article
03/08/2023

La routine RtlSetOwnerSecurityDescriptor définit les informations de propriétaire d’un descripteur de sécurité au format absolu. Il remplace toutes les informations de propriétaire qui sont 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 a la valeur 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éfinissez sur TRUE si les informations de 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 SE_OWNER_DEFAULTED dans le champ SECURITY_DESCRIPTOR_CONTROL du descripteur de sécurité. Si ce paramètre a la valeur FALSE, l’indicateur SE_OWNER_DEFAULTED est effacé.

Valeur retournée

RtlSetOwnerSecurityDescriptor peut retourner l’un des codes status suivants :

Code de retour	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é 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.

Configuration requise

Condition requise	Valeur
Plateforme cible	Universal
En-tête	ntifs.h (inclure Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe (mode noyau) ; Ntdll.dll (mode utilisateur)
IRQL	< DISPATCH_LEVEL