Fonction RtlCreateSecurityDescriptorRelative (ntifs.h)

Article
03/08/2023

La routine RtlCreateSecurityDescriptorRelative initialise un nouveau descripteur de sécurité au format auto-relatif. Au retour, le descripteur de sécurité est initialisé avec aucune ACL système (SACL), aucune ACL discrétionnaire (DACL), aucun propriétaire, aucun groupe principal et tous les indicateurs de contrôle définis sur zéro.

Syntaxe

NTSYSAPI NTSTATUS RtlCreateSecurityDescriptorRelative(
  [out] PISECURITY_DESCRIPTOR_RELATIVE SecurityDescriptor,
  [in]  ULONG                          Revision
);

Paramètres

[out] SecurityDescriptor

Pointeur vers une mémoire tampon allouée par l’appelant, qui doit avoir au moins la taille(SECURITY_DESCRIPTOR_RELATIVE), pour recevoir le descripteur de sécurité initialisé.

[in] Revision

Niveau de révision à affecter au descripteur de sécurité. Ce paramètre doit être SECURITY_DESCRIPTOR_REVISION.

Valeur retournée

RtlCreateSecurityDescriptorRelative peut retourner l’un des éléments suivants :

Code de retour	Description
STATUS_SUCCESS	L'appel s'est terminé avec succès.
STATUS_UNKNOWN_REVISION	La révision donnée n’est pas connue ou n’est pas prise en charge.

Remarques

En effet, un appel réussi à cette routine initialise un descripteur de sécurité sans contraintes de sécurité.

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	Desktop (Expérience utilisateur)
En-tête	ntifs.h (inclure Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL