Função RtlNextUnicodePrefix (ntifs.h)

  • Artigo

A rotina RtlNextUnicodePrefix é usada para enumerar os elementos em uma tabela de prefixo Unicode.

Sintaxe

NTSYSAPI PUNICODE_PREFIX_TABLE_ENTRY RtlNextUnicodePrefix(
  [in] PUNICODE_PREFIX_TABLE PrefixTable,
  [in] BOOLEAN               Restart
);

Parâmetros

[in] PrefixTable

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

[in] Restart

Defina como TRUE se a enumeração for iniciar no primeiro elemento da tabela. Defina como FALSE se retomar a enumeração de uma chamada anterior.

Para enumerar todos os elementos na tabela, use RtlNextUnicodePrefix da seguinte maneira:

for (p = RtlNextUnicodePrefix ( Table, TRUE );
     p != NULL;
     p = RtlNextUnicodePrefix ( Table, FALSE )) {
        // Process the element pointed to by p
}

Retornar valor

RtlNextUnicodePrefix retorna um ponteiro para o próximo elemento, se houver um. Se não houver mais elementos na tabela, RtlNextUnicodePrefix retornará NULL.

Comentários

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. 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 tratamento de cadeia de caracteres, consulte Rotinas 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

RtlInsertUnicodePrefix

RtlRemoveUnicodePrefix