FsRtlIsNameInExpression, fonction (ntifs.h)
La routine FsRtlIsNameInExpression détermine si une chaîne Unicode correspond au modèle spécifié.
Syntaxe
BOOLEAN FsRtlIsNameInExpression(
[in] PUNICODE_STRING Expression,
[in] PUNICODE_STRING Name,
[in] BOOLEAN IgnoreCase,
[in, optional] PWCH UpcaseTable
);
Paramètres
[in] Expression
Pointeur vers la chaîne de modèle. Peut contenir des caractères génériques. Si IgnoreCase est TRUE, Expression doit être en majuscules.
[in] Name
Pointeur vers la chaîne à comparer au modèle. Impossible de contenir des caractères génériques.
[in] IgnoreCase
Définissez la valeur TRUE pour la correspondance sans respect de la casse, FALSE sinon.
[in, optional] UpcaseTable
Pointeur facultatif vers la table de caractères majuscules à utiliser pour la correspondance sans respect de la casse. Si cette valeur n’est pas fournie, la table de caractères majuscules système par défaut est utilisée.
Valeur de retour
FsRtlIsNameInExpression retourne TRUE si la chaîne correspond au modèle, FALSE sinon.
Remarques
Les caractères génériques suivants peuvent être utilisés dans la chaîne de modèle.
| Caractère générique | Signification |
|---|---|
| * (astérisque) | Correspond à zéro ou plusieurs caractères. |
| ? (point d’interrogation) | Correspond à un caractère unique. |
| DOS_DOT | Correspond à un point ou zéro caractères au-delà de la chaîne de nom. |
| DOS_QM | Correspond à n’importe quel caractère unique ou, lors de la rencontre d’un point ou d’une fin de chaîne de nom, avance l’expression à la fin de l’ensemble de DOS_QMs contigus. |
| DOS_STAR | Correspond à zéro ou plusieurs caractères jusqu’à ce qu’ils rencontrent et correspondent à la finale. dans le nom. |
Dans des conditions de ressources faibles, FsRtlIsNameInExpression peut déclencher une exception structurée avec un code de STATUS_NO_MEMORY, que les appelants doivent être prêts à gérer. Pour plus d’informations, consultez gestion des exceptions structurées.
Note
Si un seul des paramètres de chaîne a une longueur égale à zéro, FsRtlIsNameInExpression retourne FALSE. Cela signifie que « * » ne correspond pas à une chaîne Null.
Si les deux paramètres sont des chaînes Null, FsRtlIsNameInExpression retourne TRUE.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Cette routine est Windows 2000 |
| plateforme cible | Universel |
| d’en-tête | ntifs.h (include FltKernel.h, Ntifs.h) |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| règles de conformité DDI | HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm) |