Fonction RtlInsertUnicodePrefix (ntifs.h)

Article
02/29/2024

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é à l’appelant, qui doit être au moins sizeof(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 retournée

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 préfixe.

Remarques

Chaque entrée de préfixe dans la table est un nom de chemin 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 ().

Après avoir inséré le nouvel élément, RtlInsertUnicodePrefix 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 n’importe quel autre Rtl.. Routines UnicodePrefix dessus. La structure de table de préfixes initialisée doit être considérée comme opaque.

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 d’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 (inclure Ntifs.h)
Bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	< DISPATCH_LEVEL