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。 如果 AllocateDestinationString 为 TRUE，则设置 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