Функция RtlNextUnicodePrefix (ntifs.h)

Статья
02/26/2024

Подпрограмма 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

См. также раздел

RtlFindUnicodePrefix

RtlInitializeUnicodePrefix

RtlInsertUnicodePrefix

RtlRemoveUnicodePrefix

Share via