RtlUnicodeStringToOemString 函数 (winternl.h)

将指定的 Unicode 源字符串转换为 OEM 字符串。 转换是针对 OEM 代码页 (OCP) 完成的。

语法

NTSTATUS RtlUnicodeStringToOemString(
  [out] POEM_STRING      DestinationString,
  [in]  PCUNICODE_STRING SourceString,
  [in]  BOOLEAN          AllocateDestinationString
);

参数

[out] DestinationString

指向 OEM_STRING 结构的指针,该结构包含与 Unicode 源字符串等效的 OEM。 如果 AllocateDestinationStringTRUE,则设置 MaximumLength 字段。

[in] SourceString

指向要转换为 OEM 的UNICODE_STRING 结构的指针。

[in] AllocateDestinationString

控制目标字符串的缓冲区空间分配。

TRUE

DestinationString 分配缓冲区空间。 如果设置为 TRUE,则必须使用 RtlFreeOemString 解除分配缓冲区。

FALSE

未为 DestinationString 分配缓冲区空间。

返回值

NTSTATUS 中定义了各种 NTSTATUS 值。H,随 Windows DDK 一起分发。

返回代码 说明
STATUS_SUCCESS
Unicode 字符串已转换为 OEM。 否则,不会分配任何存储,也未执行任何转换。

注解

此例程仅为 DestinationString 分配缓冲区。

要求

要求
最低受支持的客户端 Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器 Windows 2000 Server [仅限桌面应用]
目标平台 Windows
标头 winternl.h
Library ntdll.lib
DLL ntdll.dll