Fonction RtlGetOwnerSecurityDescriptor (ntifs.h)

Article
03/05/2024

La routine RtlGetOwnerSecurityDescriptor retourne les informations de propriétaire pour un descripteur de sécurité donné.

Syntaxe

NTSYSAPI NTSTATUS RtlGetOwnerSecurityDescriptor(
  [in]  PSECURITY_DESCRIPTOR SecurityDescriptor,
  [out] PSID                 *Owner,
  [out] PBOOLEAN             OwnerDefaulted
);

Paramètres

[in] SecurityDescriptor

Pointeur vers le descripteur de sécurité.

[out] Owner

Pointeur vers une adresse pour recevoir un pointeur vers l’identificateur de sécurité du propriétaire (SID). Si le descripteur de sécurité ne contient pas actuellement de SID propriétaire, le propriétaire reçoit NULL.

[out] OwnerDefaulted

Pointeur vers une variable booléenne qui reçoit TRUE si les informations de propriétaire sont dérivées d’un mécanisme par défaut, plutôt que par le fournisseur d’origine du descripteur de sécurité explicitement, FALSE sinon. Valide uniquement si le propriétaire reçoit une valeur non NULL .

Valeur retournée

RtlGetOwnerSecurityDescriptor retourne STATUS_SUCCESS ou une valeur NTSTATUS appropriée, par exemple :

Code de retour	Description
STATUS_UNKNOWN_REVISION	Le niveau de révision du descripteur de sécurité n’est pas connu ou n’est pas pris en charge. Il s’agit d’un code d’erreur.

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
Client minimal pris en charge	Windows 2000
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	PASSIVE_LEVEL