Função RtlOemStringToCountedUnicodeString (ntifs.h)

Artigo
02/26/2024

A rotina RtlOemStringToCountedUnicodeString converte a cadeia de caracteres de origem especificada em uma cadeia de caracteres Unicode usando a página de código OEM do sistema atual.

Sintaxe

NTSYSAPI NTSTATUS RtlOemStringToCountedUnicodeString(
       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 Unicode traduzida. Se AllocateDestinationString for FALSE, o chamador também deverá alocar um buffer para que o membro Buffer de DestinationString mantenha os dados Unicode. Se AllocateDestinationString for TRUE, RtlOemStringToCountedUnicodeString 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 RtlOemStringToCountedUnicodeString 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

Se a operação for bem-sucedida, RtlOemStringToCountedUnicodeString retornará STATUS_SUCCESS. Caso contrário, nenhum armazenamento foi alocado e nenhuma conversão foi feita.

Comentários

RtlOemStringToCountedUnicodeString retorna uma cadeia de caracteres traduzida que não inclui o terminador NULL. Ele 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.

RtlOemStringToCountedUnicodeString não modifica a cadeia de caracteres de origem.

Para obter informações sobre outras rotinas de manipulação de cadeia de caracteres, consulte Rotinas da RTL (Biblioteca em Tempo de Execução).