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

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

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

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

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

Замечания

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

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

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

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

Дополнительные сведения о других подпрограммах обработки строк см. в Run-Time подпрограммах библиотеки (RTL).

Требования

См. также

RtlFindUnicodePrefix

RtlInitializeUnicodePrefix

RtlNextUnicodePrefix

RtlRemoveUnicodePrefix

UNICODE_STRING