Fonction RtlCreateSecurityDescriptor (wdm.h)

La routine RtlCreateSecurityDescriptor initialise un nouveau descripteur de sécurité au format absolu. Au retour, le descripteur de sécurité est initialisé sans ACL système, sans ACL discrétionnaire, aucun propriétaire, aucun groupe principal et tous les indicateurs de contrôle définis sur zéro.

Syntaxe

NTSYSAPI NTSTATUS RtlCreateSecurityDescriptor(
  [out] PSECURITY_DESCRIPTOR SecurityDescriptor,
  [in]  ULONG                Revision
);

Paramètres

[out] SecurityDescriptor

Pointeur vers la mémoire tampon pour l’initialisation du SECURITY_DESCRIPTOR .

[in] Revision

Spécifie le niveau de révision à affecter au descripteur de sécurité. Définissez ce paramètre sur SECURITY_DESCRIPTOR_REVISION.

Valeur retournée

RtlCreateSecurityDescriptor 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	L’appelant a spécifié une valeur non prise en charge pour Revision.

Remarques

Un appel réussi à cette routine initialise un descripteur de sécurité. Les champs de ce descripteur sont définis sur des valeurs initiales qui indiquent qu’il n’existe aucune contrainte de sécurité.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Disponible dans Windows 2000 et versions ultérieures de Windows.
Plateforme cible	Universal
En-tête	wdm.h (include Wdm.h, Ntddk.h, Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe (mode noyau) ; Ntdll.dll (mode utilisateur)
IRQL	PASSIVE_LEVEL

Voir aussi

RtlLengthSecurityDescriptor

RtlSetDaclSecurityDescriptor

RtlValidSecurityDescriptor

SECURITY_DESCRIPTOR