Função RtlUTF8StringToUnicodeString (wdm.h)

  • Artigo

A função RtlUTF8StringToUnicodeString converte a cadeia de caracteres de origem UTF8 especificada em uma cadeia de caracteres Unicode de acordo com as informações de localidade do sistema atuais.

Sintaxe

NTSYSAPI NTSTATUS RtlUTF8StringToUnicodeString(
  PUNICODE_STRING DestinationString,
  PUTF8_STRING    SourceString,
  BOOLEAN         AllocateDestinationString
);

Parâmetros

DestinationString

Ponteiro para uma estrutura UNICODE_STRING para manter a cadeia de caracteres Unicode convertida.

Se AllocateDestinationString for TRUE, a rotina alocará um novo buffer para manter os dados da cadeia de caracteres, atualizará o membro Buffer de DestinationString para apontar para o novo buffer e definirá o campo de comprimento máximo. Caso contrário, a rotina usa o buffer especificado no momento para manter a cadeia de caracteres.

SourceString

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

AllocateDestinationString

Especifica se essa rotina deve alocar o espaço de buffer para a cadeia de caracteres de destino. Se isso acontecer, o chamador deverá desalocar o buffer chamando RtlFreeUnicodeString.

Retornar valor

Se a conversão for bem-sucedida, RtlUTF8StringToUnicodeString 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

RtlFreeUnicodeString