Função RtlUnicodeStringToCountedOemString (ntifs.h)

Artigo
03/01/2024

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

Sintaxe

NTSYSAPI NTSTATUS RtlUnicodeStringToCountedOemString(
       POEM_STRING      DestinationString,
  [in] PCUNICODE_STRING SourceString,
  [in] BOOLEAN          AllocateDestinationString
);

Parâmetros

DestinationString

Ponteiro para um buffer alocado pelo chamador para receber a cadeia de caracteres OEM contada. Se AllocateDestinationString for FALSE, o chamador também deverá alocar um buffer para o membro buffer de DestinationString armazenar os dados OEM. Se AllocateDestinationString for TRUE, RtlUnicodeStringToCountedOemString 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 Unicode de origem a ser convertida.

[in] AllocateDestinationString

Defina como TRUE se RtlUnicodeStringToCountedOemString 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 RtlFreeOemString.

Retornar valor

RtlUnicodeStringToCountedOemString retornará STATUS_SUCCESS se a cadeia de caracteres em DestinationString for traduzida. Caso contrário, nenhum armazenamento foi alocado e nenhuma conversão foi executada. Essa rotina retornará STATUS_UNMAPPABLE_CHARACTER se não puder traduzir um caractere no SourceString especificado.

Comentários

RtlUnicodeStringToCountedOemString retorna uma cadeia de caracteres traduzida que não inclui um 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 do sistema.

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

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