Fonction RtlCreateSecurityDescriptorRelative (ntifs.h)

Article
07/02/2025

Le RtlCreateSecurityDescriptorRelative routine initialise un nouveau descripteur de sécurité au format auto-relatif. Au retour, le descripteur de sécurité est initialisé sans liste de contrôle d’accès système (SACL), aucune liste de contrôle d’accès 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 être au moins taille de(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 de retour

RtlCreateSecurityDescriptorRelative pouvez retourner l’une des options suivantes :

Retourner le code	Description
STATUS_SUCCESS	L’appel s’est terminé avec succès.
STATUS_UNKNOWN_REVISION	La de 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.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000
plateforme cible	Bureau
d’en-tête	ntifs.h (include Ntifs.h)
bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL