Função RtlUpcaseUnicodeStringToOemString (ntifs.h)

Artigo
02/26/2024

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

Sintaxe

NTSYSAPI NTSTATUS RtlUpcaseUnicodeStringToOemString(
       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, RtlUpcaseUnicodeStringToOemString 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 RtlUpcaseUnicodeStringToOemString 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

RtlUpcaseUnicodeStringToOemString retornará STATUS_SUCCESS se a cadeia de caracteres em DestinationString for traduzida. Caso contrário, nenhum armazenamento foi alocado, nem nenhuma conversão foi executada.

Comentários

RtlUpcaseUnicodeStringToOemString 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 OEM em maiúsculas.

Essa rotina pode substituir um caractere padrão na cadeia de caracteres de destino por todos os caracteres de cadeia de caracteres de origem que ele não pode mapear para a página de código atual e, em seguida, retornar STATUS_SUCCESS.

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

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