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 |