Função RtlNextUnicodePrefix (ntifs.h)
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 |