(wdm.h) RtlAppendUnicodeToString 函式

RtlAppendUnicodeToString 例程會將提供的 Unicode 字串串連至緩衝的 Unicode 字串串。

語法

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

[in, out] Destination

緩衝字串的指標。

[in, optional] Source

要附加至 Destination 字串之 Null 終止字串的指標。

RtlAppendUnicodeToString 可以傳回下列其中一項：

傳回碼	Description
STATUS_SUCCESS	來源字串已成功附加至目的地字串，並更新目的字串長度以包含附加的位元組。
STATUS_BUFFER_TOO_SMALL	目的字串緩衝區太小而無法附加來源字串，因此目的地字元串長度不會更新，而且目的地字串緩衝區的內容不會變更。

RtlAppendUnicodeToString 會將來源字串附加至目的地字串的結尾。

如果目的地緩衝區不夠大，無法包含串連來源和目的地字串所產生的字串， (不包含終止來源字串的 null 字元) ，則例程會傳回STATUS_BUFFER_TOO_SMALL，並讓目的地字元串保持不變。

如果呼叫端在 IRQL >= DISPATCH_LEVEL 執行，則目的地緩衝區必須存留。

需求	值
最低支援的用戶端	從 Windows 2000 開始提供。
目標平台	Universal
標頭	wdm.h (包括 Wdm.h、Ntddk.h、Ntifs.h、Wudfwdm.h)
程式庫	NtosKrnl.lib
Dll	NtosKrnl.exe (核心模式) ;Ntdll.dll (使用者模式)
IRQL	請參閱一節。