strCatChainW 函式 (shlwapi.h)

串連兩個 Unicode 字串。需要重複串連至相同緩衝區時使用。

語法

DWORD StrCatChainW(
  [out] PWSTR  pszDst,
        DWORD  cchDst,
        DWORD  ichAt,
  [in]  PCWSTR pszSrc
);

[out] pszDst

類型： PWSTR

緩衝區的指標，當此函式成功傳回時，會收到 Null 終止的 Unicode 字串。

cchDst

類型： DWORD

目的地緩衝區的大小，以字元為單位。此緩衝區的大小必須足夠，才能保存兩個字元串以及終止的 Null 字元。如果緩衝區太小，則會截斷最終字串。

ichAt

類型： DWORD

要開始附加動作之目的地緩衝區中的位移。如果字串不是空的，請將此值設定為 -1，讓目前的填滿字元數 (不包含為您計算的終止 Null 字元) 。

[in] pszSrc

類型： PCWSTR

Null 終止 Unicode 來源字串的指標。

類型： DWORD

傳回最後一個字元新增至 pszDst 之後的 Null 字元位移。

安全性警告： 使用此函式不正確可能會危害應用程式的安全性。最終字串不保證為 Null 終止。請考慮使用下列其中一個替代方案：StringCbCatEx、StringCbCatNEx、StringCchCatEx 或 StringCchCatNEx。您應該先檢閱安全性考慮：Microsoft Windows Shell ，再繼續進行。