RtlUnicodeStringToOemString 函数 (ntifs.h)
RtlUnicodeStringToOemString 例程使用当前系统 OEM 代码页将给定的 Unicode 源字符串转换为 OEM 字符串。
语法
NTSYSAPI NTSTATUS RtlUnicodeStringToOemString(
POEM_STRING DestinationString,
[in] PCUNICODE_STRING SourceString,
[in] BOOLEAN AllocateDestinationString
);
参数
DestinationString
指向调用方分配的缓冲区的指针,用于接收 OEM 字符串。 如果 AllocateDestinationStringFALSE,则调用方还必须为 DestinationString 的 Buffer 成员分配缓冲区以保存 OEM 数据。 如果 AllocateDestinationStringTRUE,则 RtlUnicodeStringToOemString 分配足够大的缓冲区来容纳字符串,在 Buffer中传递指向它的指针,并相应地更新 DestinationString 的长度和最大长度成员。
[in] SourceString
指向要转换的 Unicode 字符串的指针。
[in] AllocateDestinationString
如果 RtlUnicodeStringToOemString 应为 DestinationString分配缓冲区空间,则设置为 TRUE;否则 为 FALSE。 如果此参数 TRUE,则调用方负责通过调用 RtlFreeOemString来释放缓冲区。
返回值
RtlUnicodeStringToOemString 在 DestinationString 转换时返回STATUS_SUCCESS。 否则,未分配存储,未执行转换。
言论
RtlUnicodeStringToOemString 使用安装在系统启动时作为当前系统代码页的 OEM 代码页转换给定的源字符串。
RtlUnicodeStringToOemString 不会修改源字符串。 它返回以 null 结尾的 OEM 字符串。
有关其他字符串处理例程的信息,请参阅 Run-Time Library (RTL) 例程。
要求
要求 | 价值 |
---|---|
目标平台 | 普遍 |
标头 | ntifs.h (include Ntifs.h) |
库 | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | < DISPATCH_LEVEL |
另请参阅
RtlUnicodeStringToCountedOemString