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