Função RtlUpcaseUnicodeToMultiByteN (ntifs.h)

Artigo
08/07/2023

A rotina RtlUpcaseUnicodeToMultiByteN converte a cadeia de caracteres Unicode especificada em uma nova cadeia de caracteres maiúscula, usando a ACP (página de código ANSI) do sistema atual. A cadeia de caracteres traduzida não é necessariamente de um conjunto de caracteres multibyte.

Sintaxe

NTSYSAPI NTSTATUS RtlUpcaseUnicodeToMultiByteN(
  [out]           PCHAR  MultiByteString,
  [in]            ULONG  MaxBytesInMultiByteString,
  [out, optional] PULONG BytesInMultiByteString,
  [in]            PCWCH  UnicodeString,
  [in]            ULONG  BytesInUnicodeString
);

Parâmetros

[out] MultiByteString

Ponteiro para um buffer alocado pelo chamador para receber a cadeia de caracteres traduzida.

[in] MaxBytesInMultiByteString

Número máximo de bytes a serem gravados em MultiByteString. Se esse valor fizer com que a cadeia de caracteres traduzida seja truncada, RtlUpcaseUnicodeToMultiByteN não retornará um erro status.

[out, optional] BytesInMultiByteString

Ponteiro para uma variável alocada pelo chamador que recebe o comprimento, em bytes, da cadeia de caracteres traduzida. Este parâmetro pode ser NULL.

[in] UnicodeString

Ponteiro para a cadeia de caracteres de origem Unicode a ser convertida.

[in] BytesInUnicodeString

Tamanho, em bytes, da cadeia de caracteres em UnicodeString.

Retornar valor

RtlUpcaseUnicodeToMultiByteN retorna STATUS_SUCCESS.

Comentários

RtlUpcaseUnicodeToMultiByteN converte a cadeia de caracteres Unicode fornecida usando a página de código ANSI do sistema atual instalada na hora de inicialização do sistema e converte a cadeia de caracteres traduzida em maiúsculas.

Essa rotina não modifica a cadeia de caracteres de origem. Ele retornará uma cadeia de caracteres ANSI terminada em NULL se o BytesInUnicodeString especificado incluir um terminador NULL e se o MaxBytesInMultiByteString especificado não causar truncamento.

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