RtlCopyUnicodeString 函数 (wdm.h)
RtlCopyUnicodeString 例程将源字符串复制到目标字符串。
语法
NTSYSAPI VOID RtlCopyUnicodeString(
[in, out] PUNICODE_STRING DestinationString,
[in, optional] PCUNICODE_STRING SourceString
);
参数
[in, out] DestinationString
指向目标字符串缓冲区的指针。 此参数指向 UNICODE_STRING 结构。
[in, optional] SourceString
指向源字符串缓冲区的指针。 此参数指向 UNICODE_STRING 结构。
返回值
无
备注
如果 SourceString 为 NULL，则此例程将 DestinationString 指向的结构的 Length 字段设置为零。
此例程不会修改 DestinationString 指向的结构的 MaximumLength 和 Buffer 字段。
从源字符串复制的字节数是由 SourceString) 指向的结构的 Length 成员指定的源字符串长度 (，或者是由 DestinationString) 指向的结构的 MaximumLength 成员指定的目标字符串的最大长度 (，以较小者为准。
调用方必须在调用 RtlCopyUnicodeString 之前正确初始化 DestinationString 指向的结构的所有成员。 在调用此例程之前未能初始化 Length 或 MaximumLength 成员可能会导致缓冲区溢出。
如果调用方以 IRQL >= DISPATCH_LEVEL 运行，则 DestinationString 和 SourceString 缓冲区必须驻留。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 从 Windows 2000 开始可用。 |
| 目标平台 | 通用 |
| 标头 | wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h、Wudfwdm.h) |
| Library | NtosKrnl.lib |
| DLL | NtosKrnl.exe (内核模式) ;Ntdll.dll (用户模式) |
| IRQL | 任何级别 (请参阅备注部分) |