Função RtlUpcaseUnicodeToOemN (ntifs.h)

Artigo
02/29/2024

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

Sintaxe

NTSYSAPI NTSTATUS RtlUpcaseUnicodeToOemN(
  [out]           PCHAR  OemString,
  [in]            ULONG  MaxBytesInOemString,
  [out, optional] PULONG BytesInOemString,
  [in]            PCWCH  UnicodeString,
  [in]            ULONG  BytesInUnicodeString
);

Parâmetros

[out] OemString

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

[in] MaxBytesInOemString

Número máximo de bytes a serem gravados em OemString.

[out, optional] BytesInOemString

Ponteiro para uma variável alocada pelo chamador que recebe o número de bytes na 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

RtlUnicodeToOemN retornará STATUS_SUCCESS se a cadeia de caracteres completa em UnicodeString tiver sido convertida com êxito, convertida em maiúscula e retornada em OemString. Caso contrário, ele poderá retornar STATUS_BUFFER_OVERFLOW se a cadeia de caracteres de destino precisar ser truncada para se ajustar ao MaxBytesInOemString especificado.

Comentários

Para o valor retornado STATUS_BUFFER_OVERFLOW, a cadeia de caracteres truncada em OemString foi convertida sem erro.

Para o valor retornado STATUS_SUCCESS, o valor em BytesInOemString, se houver, indica o comprimento da cadeia de caracteres retornada, em vez do MaxBytesInOemString fornecido.

Essa rotina não modifica a cadeia de caracteres de origem. Ele retornará uma cadeia de caracteres OEM terminada em nulo se bytesInUnicodeString tiver incluído um terminador NULL e se o MaxBytesInOemString 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).