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

Статья
02/29/2024

Подпрограмма RtlInsertUnicodePrefix вставляет новый элемент в таблицу префиксов Юникода.

Синтаксис

NTSYSAPI BOOLEAN RtlInsertUnicodePrefix(
  [in]  PUNICODE_PREFIX_TABLE            PrefixTable,
  [in]  __drv_aliasesMem PUNICODE_STRING Prefix,
  [out] PUNICODE_PREFIX_TABLE_ENTRY      PrefixTableEntry
);

Параметры

[in] PrefixTable

Указатель на таблицу префиксов. Таблица должна быть инициализирована путем вызова RtlInitializeUnicodePrefix.

[in] Prefix

Указатель на строку имени для вставки с элементом PrefixTableEntry.

[out] PrefixTableEntry

Указатель на хранилище, выделенное вызывающим объектом, которое должно быть не менее sizeof(UNICODE_PREFIX_TABLE_ENTRY), чтобы вставить элемент в новый префикс. RtlInsertUnicodePrefix инициализирует этот элемент, который должен считаться непрозрачным вызывающим.

Возвращаемое значение

Функция RtlInsertUnicodePrefix возвращает значение TRUE , если новый элемент был вставлен в таблицу префиксов, или false , если повторяющийся элемент уже существует в таблице префиксов.

Каждая префиксная запись в таблице представляет собой путь относительно корневого каталога тома файловой системы. Для правильного формата префикс должен начинаться с одной обратной косой черты ().

После вставки нового элемента RtlInsertUnicodePrefix повторно балансирует дерево воспроизведения таблицы префиксов.

Файловые системы должны вызывать RtlInitializeUnicodePrefix , чтобы инициализировать таблицу префиксов, прежде чем использовать любой другой Rtl.. Процедуры UnicodePrefix для него. Инициализированную структуру таблицы префиксов следует считать непрозрачной.

Вызывающие объект Rtl.. Подпрограммы UnicodePrefix отвечают за синхронизацию доступа к таблице префиксов. Быстрый мьютекс является наиболее эффективным механизмом синхронизации для этой цели.

Сведения о других процедурах обработки строк см. в статье Подпрограммы библиотеки времени выполнения (RTL).

Требования

Требование	Значение
Минимальная версия клиента	Windows XP
Минимальная версия сервера	Windows Server 2003
Целевая платформа	Универсальное
Верхняя часть	ntifs.h (включая Ntifs.h)
Библиотека	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	< DISPATCH_LEVEL