Função RtlUTF8StringToUnicodeString (wdm.h)
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 |