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	任何级别 (请参阅备注部分)