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éfini sur TRUE si l’énumération doit commencer au premier élément de la table. Définissez la valeur 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 de retour
RtlNextUnicodePrefix retourne un pointeur vers l’élément suivant, s’il en existe un. 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 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 |