Partilhar via

Função RtlInitUTF8StringEx (ntifs.h)

  • Artigo

RtlInitUTF8StringEx inicializa uma cadeia de caracteres utf-8 contada.

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 de 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.

Valor de retorno

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

Observações

RtlInitUTF8StringEx define os membros da estrutura UTF8_STRING que DestinationString aponta da seguinte maneira:

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

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

  • Define o membro MaximumLength ao comprimento, em bytes, da cadeia de caracteres de origem, incluindo a terminação nula.

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 podem estar em execução no IRQL <= DISPATCH_LEVEL se o buffer de DestinationString não for de página. Normalmente, os chamadores são executados em IRQL = PASSIVE_LEVEL porque a maioria dos outros rtlxxxcadeia de caracteres rotinas não pode ser chamada na > PASSIVE_LEVEL IRQL.

Requisitos

Requisito Valor
de cliente com suporte mínimo Windows 10, versão 2004
cabeçalho ntifs.h

Consulte também

ANSI_STRING