通过

RtlDowncaseUnicodeString 函数 (ntifs.h)

  • 项目

RtlDowncaseUnicodeString 例程将指定的 Unicode 源字符串转换为小写。 转换符合当前系统区域设置信息。

语法

NTSYSAPI NTSTATUS RtlDowncaseUnicodeString(
       PUNICODE_STRING  DestinationString,
  [in] PCUNICODE_STRING SourceString,
  [in] BOOLEAN          AllocateDestinationString
);

参数

DestinationString

指向调用方分配的缓冲区的指针，用于接收转换后的 Unicode 字符串。 如果 AllocateDestinationString 为 FALSE，则调用方还必须为 DestinationString 的 Buffer 成员分配缓冲区，以保存 Unicode 数据。 如果 AllocateDestinationString 为 TRUE，RtlDowncaseUnicodeString 会分配一个足够大的缓冲区来保存字符串，在 Buffer 中传递指向该字符串的指针，并相应地更新 DestinationString 的长度和最大长度成员。

[in] SourceString

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

[in] AllocateDestinationString

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

返回值

如果操作成功， RtlDowncaseUnicodeString 将返回STATUS_SUCCESS。 否则，未分配任何存储，也未执行任何转换。

注解

如果调用方将 AllocateDestinationString 设置为 TRUE，RtlDowncaseUnicodeString 会将 DestinationString 的 Buffer 成员替换为指向它分配的缓冲区的指针。 即使例程返回错误状态代码，也可以覆盖旧值。

RtlDowncaseUnicodeString 不修改源字符串。

有关其他字符串处理例程的信息，请参阅 运行时库 (RTL) 例程。

要求

要求 值
目标平台 通用
标头 ntifs.h (包括 Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe
IRQL < DISPATCH_LEVEL

另请参阅

RtlFreeUnicodeString

RtlUpcaseUnicodeString

UNICODE_STRING