Fonction RtlFindUnicodePrefix (ntifs.h)

Article
02/26/2024

La routine RtlFindUnicodePrefix recherche la meilleure correspondance pour un nom de fichier Unicode donné dans une table de préfixes.

Syntaxe

NTSYSAPI PUNICODE_PREFIX_TABLE_ENTRY RtlFindUnicodePrefix(
  [in] PUNICODE_PREFIX_TABLE PrefixTable,
  [in] PCUNICODE_STRING      FullName,
  [in] ULONG                 CaseInsensitiveIndex
);

Paramètres

[in] PrefixTable

Pointeur vers la table de préfixes. La table doit avoir été initialisée en appelant RtlInitializeUnicodePrefix.

[in] FullName

Pointeur vers une chaîne Unicode contenant le chemin complet d’un fichier.

[in] CaseInsensitiveIndex

Position dans le nom de fichier et les chaînes de préfixe au niveau desquelles la comparaison ne respecte pas la casse. La comparaison de chaînes respecte la casse pour les premiers caractères CaseInsensitiveIndex de chaque chaîne, sans respecter la casse pour le reste de la chaîne.

Valeur	Signification
0	La comparaison de chaînes ne respecte pas la casse.
1..FullName.Length-1	La comparaison de chaînes respecte la casse pour les caractères aux positions 0 à CaseInsensitiveIndex-1, elle ne respecte pas la casse pour les caractères de la position CaseInsensitiveIndex jusqu’à la fin de la chaîne.
FullName.Length	La comparaison de chaînes respecte la casse.

Valeur retournée

RtlFindUnicodePrefix retourne un pointeur vers le préfixe approprié le plus long trouvé pour la chaîne donnée dans FullName. Si aucun préfixe correspondant n’est trouvé, RtlFindUnicodePrefix retourne NULL.

Remarques

Chaque entrée de préfixe dans la table est un chemin d’accès relatif au répertoire racine d’un volume de système de fichiers. Pour être bien formé, le préfixe doit commencer par une seule barre oblique inverse ().

Lorsqu’il trouve un préfixe correspondant, RtlFindUnicodePrefix rééquilibre l’arborescence de lecture de la table de préfixes.

Les systèmes de fichiers doivent appeler RtlInitializeUnicodePrefix pour initialiser la table de préfixes avant d’utiliser tout autre rtl.. Routines UnicodePrefix dessus. La structure de table de préfixes initialisée doit être considérée comme opaque.

Les appelants du Rtl.. Les routines UnicodePrefix sont responsables de la synchronisation de l’accès à la table de préfixes. Un mutex rapide est le mécanisme de synchronisation le plus efficace à utiliser à cet effet.

Pour plus d’informations sur les autres routines de gestion de chaînes, consultez Routines de la bibliothèque d’exécution (RTL).

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP
Serveur minimal pris en charge	Windows Server 2003
Plateforme cible	Universal
En-tête	ntifs.h (include Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	PASSIVE_LEVEL