Função RtlInitUTF8String (wdm.h)

A função RtlInitUTF8String inicializa uma cadeia de caracteres contada de caracteres UTF-8.

Sintaxe

NTSYSAPI VOID RtlInitUTF8String(
  PUTF8_STRING          DestinationString,
  __drv_aliasesMem PCSZ SourceString
);

Parâmetros

DestinationString

Um ponteiro para UTF8_STRING estrutura (STRING) a ser inicializada.

SourceString

Ponteiro opcional para uma cadeia de caracteres terminada em nulo. Essa cadeia de caracteres é usada para inicializar a cadeia de caracteres contada apontada por DestinationString.

Retornar valor

Nenhum

Comentários

A rotina copia o valor do ponteiro SourceString para o membro Buffer da estrutura UTF8_STRING apontada por DestinationString. O membro Length dessa estrutura é definido como o comprimento, em bytes, da cadeia de caracteres de origem, excluindo o nulo de terminação. O membro MaximumLength da estrutura é definido 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.

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

Requisitos

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

Confira também

RtlInitAnsiString