(ntifs.h) RtlUnicodeToOemN 函式

  • 發行項

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

語法

NTSYSAPI NTSTATUS RtlUnicodeToOemN(
  [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。

備註

針對傳回值 STATUS_BUFFER_OVERFLOW，OemString 上的截斷字串已轉譯，而不會發生錯誤。

對於傳回值STATUS_SUCCESS，如果有任何， 則為 BytesInOemString 的值會指出傳回字串的長度，而不是指定的 MaxBytesInOemString。

RtlUnicodeToOemN 不會修改來源字串。 如果指定的 BytesInUnicodeString 包含 NULL 終止符，而且指定的 MaxBytesInOemString 未造成截斷，它會傳回 Null 終止 OEM 字符串。

如需其他字串處理程式的資訊，請參閱 Run-Time Library (RTL) 例程。

規格需求

需求 值
目標平台 Universal
標頭 ntifs.h (包含 Ntifs.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe
IRQL < DISPATCH_LEVEL

另請參閱

RtlOemToUnicodeN

RtlUnicodeStringToCountedOemString

RtlUnicodeStringToOemString