(ntifs.h) RtlUpcaseUnicodeToOemN 函式

發行項
02/29/2024

RtlUpcaseUnicodeToOemN 例程會使用目前的系統 OEM 代碼頁，將指定的 Unicode 字串轉譯成大寫 OEM 字串。

語法

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

參數

[out] OemString

呼叫端配置的緩衝區指標，以接收已翻譯的字串。

[in] MaxBytesInOemString

要寫入 OemString 的最大位元元數目。

[out, optional] BytesInOemString

呼叫端配置的變數指標，該變數會接收已翻譯字串中的位元元組數目。此參數可以是 Null。

[in] UnicodeString

要翻譯之 Unicode 來源字串的指標。

[in] BytesInUnicodeString

在 UnicodeString 處的字串大小，以位元組為單位。

傳回值

如果 UnicodeString 的完整字串成功轉譯、轉換成大寫，並在 OemString 傳回，則 RtlUnicodeToOemN 會傳回STATUS_SUCCESS。否則，如果必須截斷目的字串，以符合指定的 MaxBytesInOemString，它可以傳回STATUS_BUFFER_OVERFLOW。