RtlUpcaseUnicodeToOemN 函数 (ntifs.h)

项目
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。