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, l’expression doit être majuscule.

[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 casse, FALSE sinon.

[in, optional] UpcaseTable

Pointeur facultatif vers la table de caractères majuscules à utiliser pour la correspondance sans 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, 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’une chaîne de nom ou d’une période, avance l’expression à la fin de l’ensemble de DOS_QMs contiguës.
DOS_STAR Correspond à zéro ou plus de caractères jusqu’à ce qu’ils rencontrent et correspondent au final. 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.

Notes

Si un seul des paramètres de chaîne a une longueur de 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.

Configuration requise

   
Client minimal pris en charge Cette routine est disponible dans Windows 2000 et versions ultérieures du système d’exploitation Windows.
Plateforme cible Universal
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 HwStorPortProhibitedDIs(storport), PowerIrpDDis(wdm)

Voir aussi

FsRtlIsDbcsInExpression

UNICODE_STRING