FsRtlAreNamesEqual, fonction (ntifs.h)
La routine FsRtlAreNamesEqual détermine si deux chaînes Unicode sont égales.
Syntaxe
BOOLEAN FsRtlAreNamesEqual(
[in] PCUNICODE_STRING ConstantNameA,
[in] PCUNICODE_STRING ConstantNameB,
[in] BOOLEAN IgnoreCase,
[in, optional] PCWCH UpcaseTable
);
Paramètres
[in] ConstantNameA
Pointeur vers la première chaîne. Impossible de contenir des caractères génériques.
[in] ConstantNameB
Pointeur vers la deuxième chaîne. 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
FsRtlAreNamesEqual retourne TRUE si les deux chaînes Unicode correspondent, FALSE sinon.
Remarques
Le tableau pointé par UpcaseTable est un tableau de caractères Unicode majuscules, indexés par le caractère Unicode à convertir en majuscules. Le tableau doit contenir des entrées pour tous les caractères qui sont légaux dans les noms de fichiers.
La correspondance sans respect de la casse est effectuée en convertissant les deux chaînes en majuscules avant qu’elles ne soient comparées. Ainsi, la valeur de UpcaseTable, si fournie, est utilisée uniquement si ignoreCase est TRUE.
Si un échec d’allocation de pool se produit, FsRtlAreNamesEqual déclenche une exception STATUS_NO_MEMORY.
Pour plus d’informations sur les autres routines de gestion des chaînes, consultez Run-Time Routines de bibliothèque (RTL).
Exigences
| Exigence | Valeur |
|---|---|
| plateforme cible | Universel |
| d’en-tête | ntifs.h (include Ntifs.h) |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| règles de conformité DDI | HwStorPortProhibitedDDIs(storport), PowerIrpDDis(wdm) |