Compartilhar via


Função RtlAnsiStringToUnicodeString (winternl.h)

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

Sintaxe

NTSTATUS RtlAnsiStringToUnicodeString(
  [in, out] PUNICODE_STRING DestinationString,
  [in]      PCANSI_STRING   SourceString,
  [in]      BOOLEAN         AllocateDestinationString
);

Parâmetros

[in, out] DestinationString

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

Um ponteiro para a estrutura ANSI_STRING que contém a cadeia de caracteres ANSI a ser convertida em Unicode.

[in] AllocateDestinationString

Controla a alocação de espaço em buffer para a cadeia de caracteres de destino.

TRUE

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

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 do Windows.

Código de retorno Descrição
STATUS_SUCCESS
A cadeia de caracteres ANSI foi convertida em Unicode. Em caso de falha, a rotina não aloca nenhuma memória.

Comentários

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

Se o chamador definir AllocateDestinationString como TRUE, a rotina substituirá o membro Buffer de DestinationString por um ponteiro para o buffer alocado. O valor antigo pode ser substituído mesmo quando a rotina retorna um erro status código.

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

Requisitos

   
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