Функция RtlNextUnicodePrefix (ntifs.h)
Подпрограмма RtlNextUnicodePrefix используется для перечисления элементов в таблице префиксов Юникода.
Синтаксис
NTSYSAPI PUNICODE_PREFIX_TABLE_ENTRY RtlNextUnicodePrefix(
[in] PUNICODE_PREFIX_TABLE PrefixTable,
[in] BOOLEAN Restart
);
Параметры
[in] PrefixTable
Указатель на таблицу префиксов. Таблица должна быть инициализирована путем вызова RtlInitializeUnicodePrefix.
[in] Restart
Задайте значение TRUE , если перечисление начинается с первого элемента в таблице. Установите значение FALSE , если возобновляет перечисление из предыдущего вызова.
Чтобы перечислить все элементы в таблице, используйте RtlNextUnicodePrefix следующим образом:
for (p = RtlNextUnicodePrefix ( Table, TRUE );
p != NULL;
p = RtlNextUnicodePrefix ( Table, FALSE )) {
// Process the element pointed to by p
}
Возвращаемое значение
RtlNextUnicodePrefix возвращает указатель на следующий элемент, если он существует. Если в таблице больше нет элементов, функция RtlNextUnicodePrefix возвращает значение NULL.
Комментарии
Файловые системы должны вызывать RtlInitializeUnicodePrefix , чтобы инициализировать таблицу префиксов, прежде чем использовать любой другой Rtl.. Процедуры UnicodePrefix для него. Инициализированную структуру таблицы префиксов следует считать непрозрачной.
Вызывающие объект Rtl.. Подпрограммы UnicodePrefix отвечают за синхронизацию доступа к таблице префиксов. Быстрый мьютекс является наиболее эффективным механизмом синхронизации для этой цели.
Сведения о других процедурах обработки строк см. в статье Подпрограммы библиотеки времени выполнения (RTL).
Требования
Требование | Значение |
---|---|
Минимальная версия клиента | Windows XP |
Минимальная версия сервера | Windows Server 2003 |
Целевая платформа | Универсальное |
Верхняя часть | ntifs.h (включая Ntifs.h) |
Библиотека | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | < DISPATCH_LEVEL |