Função RtlUnicodeStringToAnsiString (wdm.h)
A rotina RtlUnicodeStringToAnsiString converte uma determinada cadeia de caracteres Unicode em uma cadeia de caracteres ANSI.
Sintaxe
NTSYSAPI NTSTATUS RtlUnicodeStringToAnsiString(
[in, out] PANSI_STRING DestinationString,
[in] PCUNICODE_STRING SourceString,
[in] BOOLEAN AllocateDestinationString
);
Parâmetros
[in, out] DestinationString
Ponteiro para uma estrutura ANSI_STRING para manter a cadeia de caracteres ANSI convertida. Se AllocateDestinationString for TRUE, a rotina alocará um novo buffer para manter os dados de 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.
[in] SourceString
Ponteiro para a cadeia de caracteres de origem Unicode a ser convertida em ANSI.
[in] AllocateDestinationString
TRUE se essa rotina for alocar o espaço de buffer para DestinationString. Se isso acontecer, o buffer deverá ser desalocado chamando RtlFreeAnsiString.
Retornar valor
Se a conversão for bem-sucedida, RtlUnicodeStringToAnsiString retornará STATUS_SUCCESS. Caso contrário, nenhum armazenamento foi alocado e nenhuma conversão foi feita.
Comentários
A tradução é feita de acordo com as informações atuais de localidade do sistema.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Disponível a partir do Windows 2000. |
| Plataforma de Destino | Universal |
| Cabeçalho | wdm.h (include Wdm.h, Ntddk.h, Ntifs.h) |
| Biblioteca | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | PASSIVE_LEVEL |