RtlUnicodeStringCopy 函数 （ntstrsafe.h）
RtlUnicodeStringCopy 函数将字符串从一个 UNICODE_STRING 结构复制到另一个结构。
语法
NTSTRSAFEDDI RtlUnicodeStringCopy(
[out] PUNICODE_STRING DestinationString,
[in] PCUNICODE_STRING SourceString
);
参数
[out] DestinationString
指向 UNICODE_STRING 结构的指针。 源字符串将复制到目标字符串。 结构字符串缓冲区中的最大字节数NTSTRSAFE_UNICODE_STRING_MAX_CCH * sizeof（WCHAR）。
[in] SourceString
指向 UNICODE_STRING 结构的指针。 此结构包含包含源字符串的缓冲区。 此字符串将复制到目标字符串。 结构字符串缓冲区中的最大字节数NTSTRSAFE_UNICODE_STRING_MAX_CCH * sizeof（WCHAR）。
返回值
RtlUnicodeStringCopy 返回以下 NTSTATUS 值之一。
| 返回代码 | 描述 |
|---|---|
|
此 成功 状态意味着源数据存在，字符串在没有截断的情况下复制，结果目标缓冲区以 null 结尾。 |
|
此 警告 状态意味着复制作由于缓冲区空间不足而未完成。 目标缓冲区包含源字符串的截断版本。 |
|
此 错误 状态意味着函数收到了无效的输入参数。 有关详细信息，请参阅以下列表。 |
RtlUnicodeStringCopy 在发生以下任一情况时返回STATUS_INVALID_PARAMETER值：
- UNICODE_STRING 结构的内容无效。
- 目标缓冲区已满。
- 缓冲区指针 NULL。
- 目标缓冲区的长度为零，但存在非零长度源字符串。
言论
RtlUnicodeStringCopy 函数使用目标缓冲区的大小来确保复制作不会写入缓冲区末尾。 如果必须在目标缓冲区的末尾截断该字符串，则该函数不会终止具有 null 字符的结果字符串。
如果源字符串和目标字符串重叠，则函数的行为是未定义的。
SourceString 和 DestinationString 指针不能 NULL。 如果需要处理 NULL 指针值，请使用 RtlUnicodeStringCopyEx 函数。
有关安全字符串函数的详细信息，请参阅 使用安全字符串函数。
要求
| 要求 | 价值 |
|---|---|
| 最低支持的客户端 | 在 Windows XP 中提供 Service Pack 1（SP1）和更高版本的 Windows。 |
| 目标平台 | 桌面 |
| 标头 | ntstrsafe.h （包括 Ntstrsafe.h） |
| 库 | Ntstrsafe.lib |
| IRQL | 如果正在作的字符串始终驻留在内存中，则为任何字符串，否则PASSIVE_LEVEL |