Função RtlOemStringToUnicodeString (ntifs.h)

Artigo
02/26/2024

A rotina RtlOemStringToUnicodeString converte uma determinada cadeia de caracteres de origem em uma cadeia de caracteres Unicode terminada em nulo usando a página de código OEM do sistema atual.

Sintaxe

NTSYSAPI NTSTATUS RtlOemStringToUnicodeString(
       PUNICODE_STRING DestinationString,
  [in] PCOEM_STRING    SourceString,
  [in] BOOLEAN         AllocateDestinationString
);

Parâmetros

DestinationString

Ponteiro para um buffer alocado pelo chamador para receber a cadeia de caracteres traduzida. Se AllocateDestinationString for FALSE, o chamador também deverá alocar um buffer para o membro Buffer de DestinationString manter a cadeia de caracteres Unicode terminada em nulo. Se AllocateDestinationString for TRUE, RtlOemStringToUnicodeString alocará um buffer grande o suficiente para manter a cadeia de caracteres, passará um ponteiro para ele no Buffer e atualizará os membros de comprimento e comprimento máximo de DestinationString adequadamente.

[in] SourceString

Ponteiro para a cadeia de caracteres OEM a ser convertida em Unicode.

[in] AllocateDestinationString

Defina como TRUE se RtlOemStringToUnicodeString deve alocar o espaço de buffer para DestinationString, caso contrário, FALSE . Se esse parâmetro for TRUE, o chamador será responsável por liberar o buffer quando ele não for mais necessário chamando RtlFreeUnicodeString.

Retornar valor

RtlOemStringToUnicodeString retornará STATUS_SUCCESS se retornar uma cadeia de caracteres traduzida em DestinationString. Caso contrário, nenhum armazenamento foi alocado e nenhuma conversão foi feita.

Comentários

RtlOemStringToUnicodeString converte a cadeia de caracteres de origem fornecida usando a página de código OEM que foi instalada como a página de código do sistema atual no momento da inicialização do sistema.

Essa rotina não modifica a cadeia de caracteres de origem. Ele retorna uma cadeia de caracteres Unicode terminada em NULL.

Para obter informações sobre outras rotinas de tratamento de cadeia de caracteres, consulte Rotinas rtl (biblioteca em tempo de execução).