Função RtlUpcaseUnicodeToOemN (ntifs.h)

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

Requisitos

Requisito Valor
Plataforma de Destino Universal
Cabeçalho ntifs.h (inclua Ntifs.h)
Biblioteca NtosKrnl.lib
DLL NtosKrnl.exe
IRQL < DISPATCH_LEVEL

Confira também

RtlUnicodeStringToOemSize

RtlUnicodeToOemN

RtlUpcaseUnicodeStringToCountedOemString

RtlUpcaseUnicodeStringToOemString