RtlUnicodeStringToCountedOemString 函数（ntifs.h）

项目
2025/02/07

RtlUnicodeStringToCountedOemString 例程使用当前系统 OEM 代码页将指定的 Unicode 源字符串转换为计数的 OEM 字符串。

语法

NTSYSAPI NTSTATUS RtlUnicodeStringToCountedOemString(
       POEM_STRING      DestinationString,
  [in] PCUNICODE_STRING SourceString,
  [in] BOOLEAN          AllocateDestinationString
);

参数

DestinationString

指向调用方分配的缓冲区的指针，用于接收计数的 OEM 字符串。如果 AllocateDestinationStringFALSE，则调用方还必须为 DestinationString 的 Buffer 成员分配缓冲区以保存 OEM 数据。如果 AllocateDestinationString为 TRUE，RtlUnicodeStringToCountedOemString 分配足够大的缓冲区来容纳字符串，在 Buffer中传递指向它的指针，并相应地更新 DestinationString 的长度和最大长度成员。

[in] SourceString

指向要转换的源 Unicode 字符串的指针。

[in] AllocateDestinationString

如果 RtlUnicodeStringToCountedOemString 应为 DestinationString分配缓冲区空间，则设置为 TRUE，否则 FALSE。如果此参数 TRUE，则调用方负责通过调用 RtlFreeOemString来释放缓冲区。

返回值

RtlUnicodeStringToCountedOemString 如果转换 DestinationString 处的字符串，则返回STATUS_SUCCESS。否则，未分配存储，未执行转换。如果此例程无法转换给定的 sourceString 中的字符，则返回STATUS_UNMAPPABLE_CHARACTER。