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

Confira também

ANSI_STRING

RtlAnsiStringToUnicodeString

RtlFreeAnsiString

UNICODE_STRING