rtlInitStringEx 函数 (wdm.h)
RtlInitStringEx 例程初始化 8 位字符的计数字符串。
语法
NTSYSAPI NTSTATUS RtlInitStringEx(
[out] PSTRING DestinationString,
[in, optional] __drv_aliasesMem PCSZ SourceString
);
参数
[out] DestinationString
指向要初始化的 STRING 结构的指针。 Ntdef.h 头文件将此结构定义为与 ANSI_STRING 结构相同。
[in, optional] SourceString
指向以 null 结尾的字符串的指针。 此字符串用于初始化 DestinationString 指向的计数字符串。
返回值
如果 SourceString 太长，则返回STATUS_NAME_TOO_LONG。 否则，此例程返回STATUS_SUCCESS。
注解
此例程初始化计数字符串。
例程将 SourceString 指针值复制到 DestinationString 指向的 STRING 结构的 Buffer 成员。 此结构的 Length 成员设置为源字符串的长度（以字节为单位），不包括终止 null。 结构的 MaximumLength 成员设置为源字符串的长度（以字节为单位），包括终止 null。 如果 SourceString 为 NULL， 则 Length 和 MaximumLength 都设置为零。
RtlInitStringEx 不会更改 SourceString 指向的源字符串。
如果 DestinationString 缓冲区不可分页，则 RtlInitStringEx 的调用方可以在 IRQL <= DISPATCH_LEVEL 运行。 通常，调用方在 IRQL = PASSIVE_LEVEL 运行，因为大多数其他 RtlXxx字符串 例程无法在 IRQL > PASSIVE_LEVEL调用。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 从Windows 10开始可用。 |
| 目标平台 | 通用 |
| 标头 | wdm.h（包括 Wdm.h、Ntddk.h、Ntifs.h） |
| Library | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | 请参见“备注”部分。 |