Função RtlUpcaseUnicodeStringToCountedOemString (ntifs.h)

Artigo
09/27/2023

A rotina RtlUpcaseUnicodeStringToCountedOemString converte uma determinada cadeia de caracteres de origem Unicode em uma cadeia de caracteres OEM contada em letras maiúsculas usando a página de código OEM do sistema atual.

Sintaxe

NTSYSAPI NTSTATUS RtlUpcaseUnicodeStringToCountedOemString(
       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 que o membro Buffer de DestinationString mantenha os dados do OEM. Se AllocateDestinationString for TRUE, RtlUpcaseUnicodeStringToCountedOemString 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 a ser traduzida.

[in] AllocateDestinationString

Defina como TRUE se RtlUpcaseUnicodeStringToCountedOemString 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

RtlUpcaseUnicodeStringToCountedOemString retornará STATUS_SUCCESS se retornar uma cadeia de caracteres traduzida em DestinationString. Caso contrário, nenhum armazenamento foi alocado, nem nenhuma conversão foi executada. Ele retornará STATUS_UNMAPPABLE_CHARACTER se não puder traduzir um caractere no SourceString especificado.

Comentários

RtlUpcaseUnicodeStringToCountedOemString retorna uma cadeia de caracteres que não é terminada em nulo. 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 e converte a cadeia de caracteres traduzida em maiúsculas.

Para encontrar um mapeamento de melhor correspondência para qualquer caractere especial, como um caractere de direitos autorais, na cadeia de caracteres de origem fornecida, RtlUpcaseUnicodeStringToCountedOemString executa as seguintes operações:

Converte uma cópia da cadeia de caracteres Unicode em SourceString em uma cadeia de caracteres OEM
Converte a cadeia de caracteres OEM novamente em Unicode
Converte essa nova cadeia de caracteres Unicode em maiúsculas
Converte a cadeia de caracteres Unicode maiúscula em uma cadeia de caracteres OEM contada e a retorna em DestinationString

Essa rotina 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).