RtlOemStringToUnicodeString 函数 (ntifs.h)

项目
03/05/2024

RtlOemStringToUnicodeString 例程使用当前系统 OEM 代码页将给定的源字符串转换为以 null 结尾的 Unicode 字符串。

语法

NTSYSAPI NTSTATUS RtlOemStringToUnicodeString(
       PUNICODE_STRING DestinationString,
  [in] PCOEM_STRING    SourceString,
  [in] BOOLEAN         AllocateDestinationString
);

参数

DestinationString

指向调用方分配的缓冲区的指针，用于接收已翻译的字符串。如果 AllocateDestinationString 为 FALSE，则调用方还必须为 DestinationString 的 Buffer 成员分配缓冲区，以保存以 null 结尾的 Unicode 字符串。如果 AllocateDestinationString 为 TRUE， 则 RtlOemStringToUnicodeString 分配足够大的缓冲区来保存字符串，在 Buffer 中传递指向该字符串的指针，并相应地更新 DestinationString 的长度和最大长度成员。

[in] SourceString

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

[in] AllocateDestinationString

如果 RtlOemStringToUnicodeString 应为 DestinationString 分配缓冲区空间，则设置为 TRUE，否则设置为 FALSE。如果此参数为 TRUE，则调用方负责通过调用 RtlFreeUnicodeString 在不再需要缓冲区时释放缓冲区。