Função RtlUnicodeStringToUTF8String (wdm.h)

  • Artigo

A função RtlUnicodeStringToUTF8String converte a cadeia de caracteres de origem Unicode especificada em uma cadeia de caracteres UTF8.

Sintaxe

NTSYSAPI NTSTATUS RtlUnicodeStringToUTF8String(
  PUTF8_STRING     DestinationString,
  PCUNICODE_STRING SourceString,
  BOOLEAN          AllocateDestinationString
);

Parâmetros

DestinationString

Ponteiro para uma estrutura UTF8_STRING para manter a cadeia de caracteres UTF8 convertida. Se AllocateDestinationString for TRUE, a rotina alocará um novo buffer para manter os dados da cadeia de caracteres e atualizará o membro Buffer de DestinationString para apontar para o novo buffer. Caso contrário, a rotina usa o buffer especificado no momento para manter a cadeia de caracteres. O campo de comprimento máximo só será definido se AllocateDestinationString for TRUE.

SourceString

Ponteiro para a cadeia de caracteres de origem Unicode a ser convertida em UTF8.

AllocateDestinationString

TRUE se essa rotina for alocar o espaço de buffer para DestinationString. Se isso acontecer, o buffer deverá ser desalocado chamando RtlFreeUTF8String.

Retornar valor

Se a conversão for bem-sucedida, RtlUnicodeStringToUTF8String retornará STATUS_SUCCESS. Em caso de falha, a rotina não aloca memória nem executa uma conversão.

Requisitos

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

Confira também

RtlFreeUTF8String