Fonction RtlInsertUnicodePrefix (ntifs.h)
La routine RtlInsertUnicodePrefix insère un nouvel élément dans une table de préfixe Unicode.
Syntaxe
NTSYSAPI BOOLEAN RtlInsertUnicodePrefix(
[in] PUNICODE_PREFIX_TABLE PrefixTable,
[in] __drv_aliasesMem PUNICODE_STRING Prefix,
[out] PUNICODE_PREFIX_TABLE_ENTRY PrefixTableEntry
);
Paramètres
[in] PrefixTable
Pointeur vers la table de préfixes. La table doit avoir été initialisée en appelant RtlInitializeUnicodePrefix.
[in] Prefix
Pointeur vers la chaîne de nom à insérer avec l’élément à PrefixTableEntry.
[out] PrefixTableEntry
Pointeur vers le stockage alloué par l’appelant, qui doit être au moins taille de(UNICODE_PREFIX_TABLE_ENTRY), pour que l’élément soit inséré pour le nouveau préfixe. RtlInsertUnicodePrefix initialise cet élément, qui doit être considéré comme opaque par l’appelant.
Valeur de retour
RtlInsertUnicodePrefix retourne TRUE si le nouvel élément a été inséré dans la table de préfixes, ou retourne FALSE si un élément en double existe déjà dans la table de préfixes.
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 ().
Après avoir inséré le nouvel élément, RtlInsertUnicodePrefix 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 | < DISPATCH_LEVEL |