RtlUpcaseUnicodeToOemN 函数 (ntifs.h)

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处的字符串的大小(以字节为单位)。

返回值

RtlUnicodeToOemN 如果 unicodeString 的完整字符串已成功转换、转换为大写,并在 oemString 返回,则返回STATUS_SUCCESS。 否则,如果必须截断目标字符串以适应给定 MaxBytesInOemString,则它可以返回STATUS_BUFFER_OVERFLOW。

言论

对于返回值STATUS_BUFFER_OVERFLOW,OemString 处截断的字符串已翻译,而不会出错。

对于返回值STATUS_SUCCESS,值为 BytesInOemString(如果有)指示返回的字符串的长度,而不是给定的 MaxBytesInOemString

此例程不会修改源字符串。 如果给定的 BytesInUnicodeString 包含 NULL 终止符,并且给定的 MaxBytesInOemString 不会导致截断,则它将返回以 null 结尾的 OEM 字符串。

有关其他字符串处理例程的信息,请参阅 Run-Time Library (RTL) 例程

要求

要求 价值
目标平台 普遍
标头 ntifs.h (include Ntifs.h)
NtosKrnl.lib
DLL NtosKrnl.exe
IRQL < DISPATCH_LEVEL

另请参阅

RtlUnicodeStringToOemSize

RtlUnicodeToOemN

RtlUpcaseUnicodeStringToCountedOemString

RtlUpcaseUnicodeStringToOemString