Fonction RtlFindUnicodePrefix (ntifs.h)
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 d’accès complet d’un fichier.
[in] CaseInsensitiveIndex
Position dans le nom de fichier et les chaînes de préfixe auxquelles la comparaison doit devenir insensible à la casse. La comparaison de chaînes respecte la casse pour la première CaseInsensitiveIndexIndex caractères dans chaque chaîne, sans respect de 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, sans respect de la casse pour les caractères de position CaseInsensitiveIndex à la fin de la chaîne. |
| FullName.Length | La comparaison de chaînes respecte la casse. |
Valeur de retour
RtlFindUnicodePrefix retourne un pointeur vers le préfixe approprié le plus long trouvé pour la chaîne donnée à 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 barre oblique inverse ().
Lorsqu’il trouve un préfixe correspondant, RtlFindUnicodePrefix rééquilibrer 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 d’autres Rtl.. UnicodePrefix routines dessus. La structure de table de préfixes initialisée doit être considérée comme opaque.
Appelants du Rtl.. UnicodePrefix routines 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 des chaînes, consultez Run-Time Routines de bibliothèque (RTL).
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows XP |
| serveur minimum pris en charge | Windows Server 2003 |
| plateforme cible | Universel |
| d’en-tête | ntifs.h (include Ntifs.h) |
| bibliothèque | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |