RtlInitUTF8StringEx 函数 (ntifs.h)
RtlInitUTF8StringEx 初始化 UTF-8 字符的计数字符串。
语法
NTSYSAPI NTSTATUS RtlInitUTF8StringEx(
PUTF8_STRING DestinationString,
__drv_aliasesMem PCSZ SourceString
);
参数
DestinationString
指向要初始化的UTF8_STRING结构的指针。 ntdef.h 头文件定义此结构与 ANSI_STRING 结构相同。
SourceString
指向以 null 结尾的字符串的指针。 SourceString 用于初始化 DestinationString 指向的计数字符串。
返回值
RtlInitUTF8StringEx 如果 sourceString 太长,则返回 STATUS_NAME_TOO_LONG。 否则,此例程返回STATUS_SUCCESS。
言论
RtlInitUTF8StringEx 设置 DestinationString 指向的UTF8_STRING结构的成员,如下所示:
将 SourceString 的指针值复制到 Buffer 成员中。
将 长度 成员设置为源字符串的长度(以字节为单位),不包括终止 null。
将 MaximumLength 成员设置为源字符串的长度(以字节为单位),包括终止 null。
如果 SourceString为 NULL,则 Length 和 MaximumLength 均设置为零。
RtlInitStringEx 不会更改 SourceString指向的源字符串。
如果 DestinationString 缓冲区不可分页,则 RtlInitStringEx 的调用方可以在 IRQL <= DISPATCH_LEVEL 运行。 通常,调用方在 IRQL = PASSIVE_LEVEL 运行,因为大多数其他 RtlXxx字符串 例程无法在 IRQL > PASSIVE_LEVEL 调用。
要求
要求 | 价值 |
---|---|
最低支持的客户端 | Windows 10 版本 2004 |
标头 | ntifs.h |