Função RtlInsertUnicodePrefix (ntifs.h)

A rotina RtlInsertUnicodePrefix insere um novo elemento em uma tabela de prefixo Unicode.

Sintaxe

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

Parâmetros

[in] PrefixTable

Ponteiro para a tabela de prefixo. A tabela deve ter sido inicializada chamando RtlInitializeUnicodePrefix.

[in] Prefix

Ponteiro para a cadeia de caracteres de nome a ser inserida com o elemento em PrefixTableEntry.

[out] PrefixTableEntry

Ponteiro para o armazenamento alocado pelo chamador, que deve ser pelo menos sizeof(UNICODE_PREFIX_TABLE_ENTRY), para que o elemento seja inserido para o novo prefixo. RtlInsertUnicodePrefix inicializa esse elemento, que deve ser considerado opaco pelo chamador.

Retornar valor

RtlInsertUnicodePrefix retornará TRUE se o novo elemento tiver sido inserido na tabela de prefixo ou retornará FALSE se já existir um elemento duplicado na tabela de prefixo.

Comentários

Cada entrada de prefixo na tabela é um nome de caminho relativo ao diretório raiz de um volume do sistema de arquivos. Para ser bem formado, o prefixo deve começar com uma única barra invertida ().

Depois de inserir o novo elemento, RtlInsertUnicodePrefix rebalanceia a árvore de reprodução da tabela de prefixo.

Os sistemas de arquivos devem chamar RtlInitializeUnicodePrefix para inicializar a tabela de prefixo antes de usar qualquer outro Rtl.. Rotinas UnicodePrefix nele. A estrutura inicializada da tabela de prefixo deve ser considerada opaca.

Chamadores do Rtl. As rotinas UnicodePrefix são responsáveis por sincronizar o acesso à tabela de prefixo. Um mutex rápido é o mecanismo de sincronização mais eficiente a ser usado para essa finalidade.

Para obter informações sobre outras rotinas de manipulação de cadeia de caracteres, consulte Rotinas da RTL (Biblioteca em Tempo de Execução).

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP
Servidor mínimo com suporte	Windows Server 2003
Plataforma de Destino	Universal
Cabeçalho	ntifs.h (inclua Ntifs.h)
Biblioteca	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	< DISPATCH_LEVEL

Confira também

RtlFindUnicodePrefix

RtlInitializeUnicodePrefix

RtlNextUnicodePrefix

RtlRemoveUnicodePrefix

UNICODE_STRING