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 |
|---|---|
|
L'appel s'est terminé avec succès. |
|
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 |