Fonction RtlNextUnicodePrefix (ntifs.h)

La routine RtlNextUnicodePrefix est utilisée pour énumérer les éléments d’une table de préfixe Unicode.

Syntaxe

NTSYSAPI PUNICODE_PREFIX_TABLE_ENTRY RtlNextUnicodePrefix(
  [in] PUNICODE_PREFIX_TABLE PrefixTable,
  [in] BOOLEAN               Restart
);

Paramètres

[in] PrefixTable

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

[in] Restart

Définissez la valeur TRUE si l’énumération doit commencer au premier élément de la table. Définissez sur FALSE si vous reprenez l’énumération à partir d’un appel précédent.

Pour énumérer tous les éléments de la table, utilisez RtlNextUnicodePrefix comme suit :

for (p = RtlNextUnicodePrefix ( Table, TRUE );
     p != NULL;
     p = RtlNextUnicodePrefix ( Table, FALSE )) {
        // Process the element pointed to by p
}

Valeur retournée

RtlNextUnicodePrefix retourne un pointeur vers l’élément suivant, le cas échéant. S’il n’y a plus d’éléments dans la table, RtlNextUnicodePrefix retourne NULL.

Remarques

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

Voir aussi

RtlFindUnicodePrefix

RtlInitializeUnicodePrefix

RtlInsertUnicodePrefix

RtlRemoveUnicodePrefix