Fonction FsRtlIsNameInUnUpcasedExpression (ntifs.h)

  • Article

La routine FsRtlIsNameInUnUpcasedExpression détermine si une chaîne Unicode correspond au modèle spécifié. Contrairement à la routine FsRtlIsNameInExpression, FsRtlIsNameInUnUpcasedExpression ne s’attend pas à ce que l’expression soit en majuscules si IgnoreCase a la valeur TRUE.

Syntaxe

BOOLEAN FsRtlIsNameInUnUpcasedExpression(
  PUNICODE_STRING Expression,
  PUNICODE_STRING Name,
  BOOLEAN         IgnoreCase,
  PWCH            UpcaseTable
);

Paramètres

Expression

Pointeur vers la chaîne de modèle. Peut contenir des caractères génériques. Si IgnoreCase a la valeur TRUE, Expression doit être minuscule.

Name

Pointeur vers la chaîne à comparer au modèle. Impossible de contenir des caractères génériques.

IgnoreCase

Définissez sur TRUE pour la correspondance sans respect de la casse, FALSE dans le cas contraire.

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 retournée

Retourne TRUE si la chaîne correspond au modèle, FALSE dans le cas contraire.

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, un 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 à un 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 du jeu de DOS_QMs contigus.
DOS_STAR Correspond à zéro ou plusieurs caractères jusqu’à ce qu’il rencontre et corresponde à la dernière période du nom.

Remarque

Si un seul des paramètres de chaîne a une longueur de zéro, FsRtlIsNameInUnUpcasedExpression retourne FALSE. Cela signifie que « * » ne correspond pas à une chaîne null. Si les deux paramètres sont des chaînes null, FsRtlIsNameInUnUpcasedExpression retourne TRUE.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 10 (version 1803)
Plateforme cible Universal
En-tête ntifs.h
Bibliothèque NtosKrnl.exe
IRQL PASSIVE_LEVEL

Voir aussi