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