Fonction SeValidSecurityDescriptor (wdm.h)
La routine SeValidSecurityDescriptor indique si un descripteur de sécurité donné est structurellement valide.
Syntaxe
BOOLEAN SeValidSecurityDescriptor(
[in] ULONG Length,
[in] PSECURITY_DESCRIPTOR SecurityDescriptor
);
Paramètres
[in] Length
Spécifie la taille en octets du descripteur de sécurité donné.
[in] SecurityDescriptor
Pointeur vers le SECURITY_DESCRIPTOR auto-relatif, qui doit être mis en mémoire tampon quelque part dans l’espace système.
Valeur retournée
SeValidSecurityDescriptor retourne TRUE si le descripteur de sécurité mis en mémoire tampon est structurellement valide.
Remarques
SeValidSecurityDescriptor n’applique pas de stratégie. Il vérifie simplement que les données de descripteur de sécurité données sont correctement mises en forme. En particulier, il vérifie les informations de révision, la relativité de soi, le propriétaire, l’alignement et, le cas échéant, le SID, le groupe, la LISTE de contrôle d’accès, la liste de contrôle d’accès et/ou la liste sacl ne dépassent pas la longueur donnée. Par conséquent, les appelants de SeValidSecurityDescriptor ne peuvent pas supposer qu’un TRUE retourné implique que le descripteur de sécurité donné a nécessairement un contenu valide.
Si SeValidSecurityDescriptor retourne TRUE, le descripteur de sécurité donné peut être transmis à un autre composant en mode noyau, car il est structurellement valide. Sinon, le passage d’un descripteur de sécurité structurellement non valide à manipuler par un autre composant en mode noyau peut entraîner des résultats non définis ou même un bogue système case activée.
Pour valider un descripteur de sécurité passé en mode utilisateur, appelez RtlValidSecurityDescriptor plutôt que SeValidSecurityDescriptor.
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 (inclure Wdm.h, Ntddk.h, Ntifs.h) |
| Bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| Règles de conformité DDI | HwStorPortProhibitedDDIs(storport),PowerIrpDDis(wdm) |