Fonction FsRtlAreNamesEqual (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 sur TRUE pour la correspondance sans respect de la casse, FALSE dans le cas contraire.
[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 retournée
FsRtlAreNamesEqual retourne TRUE si les deux chaînes Unicode correspondent, FALSE sinon.
Remarques
La table pointée 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 d’être comparées. Ainsi, la valeur d’UpcaseTable, si elle est fournie, est utilisée uniquement si IgnoreCase a la valeur TRUE.
Si un échec d’allocation de pool se produit, FsRtlAreNamesEqual déclenche une exception STATUS_NO_MEMORY.
Pour plus d’informations sur d’autres routines de gestion de chaînes, consultez Routines de la bibliothèque d’exécution (RTL).
Configuration requise
| Condition requise | Valeur |
|---|---|
| Plateforme cible | Universal |
| En-tête | ntifs.h (inclure Ntifs.h) |
| Bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |
| Règles de conformité DDI | HwStorPortProhibitedDDIs(storport),PowerIrpDDis(wdm) |