Função RtlInitUTF8StringEx (ntifs.h)

  • Artigo

RtlInitUTF8StringEx inicializa uma cadeia de caracteres contada de caracteres UTF-8.

Sintaxe

NTSYSAPI NTSTATUS RtlInitUTF8StringEx(
  PUTF8_STRING          DestinationString,
  __drv_aliasesMem PCSZ SourceString
);

Parâmetros

DestinationString

Ponteiro para a estrutura UTF8_STRING a ser inicializada. O arquivo de cabeçalho ntdef.h define essa estrutura como idêntica à estrutura ANSI_STRING .

SourceString

Ponteiro para uma cadeia de caracteres terminada em nulo. SourceString é usado para inicializar a cadeia de caracteres contada para a qual DestinationString aponta.

Retornar valor

RtlInitUTF8StringEx retornará STATUS_NAME_TOO_LONG se SourceString for muito longo. Caso contrário, essa rotina retornará STATUS_SUCCESS.

Comentários

RtlInitUTF8StringEx define os membros da estrutura UTF8_STRING para a qual DestinationString aponta da seguinte maneira:

  • Copia o valor do ponteiro de SourceString para o membro Buffer .

  • Define o membro Length como o comprimento, em bytes, da cadeia de caracteres de origem, excluindo o nulo de terminação.

  • Define o membro MaximumLength como o comprimento, em bytes, da cadeia de caracteres de origem, incluindo o nulo de terminação.

Se SourceString for NULL, Length e MaximumLength serão definidos como zero.

RtlInitStringEx não altera a cadeia de caracteres de origem apontada por SourceString.

Os chamadores de RtlInitStringEx poderão ser executados em IRQL <= DISPATCH_LEVEL se o buffer DestinationString não for pageable. Normalmente, os chamadores são executados em IRQL = PASSIVE_LEVEL porque a maioria das outras rotinas rtlxxxstring não podem ser chamadas em PASSIVE_LEVEL IRQL > .

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 10, versão 2004
Cabeçalho ntifs.h

Confira também

ANSI_STRING