RtlAppendUnicodeToString 函数 (wdm.h)

RtlAppendUnicodeToString 例程将提供的 Unicode 字符串连接到缓冲的 Unicode 字符串。

语法

NTSYSAPI NTSTATUS RtlAppendUnicodeToString(
  [in, out]      PUNICODE_STRING Destination,
  [in, optional] PCWSTR          Source
);

[in, out] Destination

指向缓冲字符串的指针。

[in, optional] Source

指向要追加到目标字符串的以 null 结尾的字符串的指针。

RtlAppendUnicodeToString 可以返回下列值之一：

返回代码	说明
STATUS_SUCCESS	源字符串已成功追加到目标字符串，目标字符串长度已更新为包含追加的字节。
STATUS_BUFFER_TOO_SMALL	目标字符串缓冲区太小，无法追加源字符串，因此不会更新目标字符串长度，并且不会更改目标字符串缓冲区的内容。

RtlAppendUnicodeToString 将源字符串追加到目标字符串的末尾。

如果目标缓冲区的大小不足以包含由于连接源字符串和目标字符串而生成的字符串， (不包括) 终止源字符串的 null 字符，则例程将返回STATUS_BUFFER_TOO_SMALL，并使目标字符串保持不变。

如果调用方以 IRQL >= DISPATCH_LEVEL 运行，则必须驻留目标缓冲区。

要求	值
最低受支持的客户端	从 Windows 2000 开始可用。
目标平台	通用
标头	wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h、Wudfwdm.h)
Library	NtosKrnl.lib
DLL	NtosKrnl.exe (内核模式) ;Ntdll.dll (用户模式)
IRQL	请参见“备注”部分。