Share via

Função RtlUnicodeStringToAnsiString (winternl.h)

  • Artigo

Converte a cadeia de caracteres de origem Unicode especificada em uma cadeia de caracteres ANSI.

Sintaxe

NTSTATUS RtlUnicodeStringToAnsiString(
  [in, out] PANSI_STRING     DestinationString,
  [in]      PCUNICODE_STRING SourceString,
  [in]      BOOLEAN          AllocateDestinationString
);

Parâmetros

[in, out] DestinationString

Um 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 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.

[in] SourceString

A estrutura UNICODE_STRING que contém a cadeia de caracteres de origem a ser convertida em ANSI.

[in] AllocateDestinationString

Controla a alocação do espaço de buffer para DestinationString.

TRUE

O espaço de buffer é alocado para DestinationString. Se definido como TRUE, o buffer deverá ser desalocado usando RtlFreeAnsiString.

FALSE

O espaço em buffer não é alocado para DestinationString.

Retornar valor

Os vários valores NTSTATUS são definidos em NTSTATUS. H, que é distribuído com o DDK.

Código de retorno Descrição
STATUS_SUCCESS
 A cadeia de caracteres Unicode foi convertida em ANSI. Caso contrário, nenhum armazenamento foi alocado e nenhuma conversão foi feita.

Comentários

A tradução é feita em relação às informações atuais de localidade do sistema.

Como não há biblioteca de importação para essa função, você deve usar GetProcAddress.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho winternl.h
Biblioteca ntdll.lib
DLL ntdll.dll; NtosKrnl.exe