Bagikan melalui

Fungsi StrCatChainW (shlwapi.h)

  • Artikel

Menggabungkan dua string Unicode. Digunakan saat perangkaian berulang ke buffer yang sama diperlukan.

Sintaks

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

Parameter

[out] pszDst

Jenis: PWSTR

Penunjuk ke buffer yang, ketika fungsi ini berhasil dikembalikan, menerima string Unicode yang dihentikan null.

cchDst

Jenis: DWORD

Ukuran buffer tujuan, dalam karakter. Buffer ini harus berukuran cukup untuk menahan kedua string serta karakter null yang mengakhiri. Jika buffer terlalu kecil, string akhir akan terpotong.

ichAt

Jenis: DWORD

Offset ke dalam buffer tujuan untuk memulai tindakan penampan. Jika string tidak kosong, atur nilai ini ke -1 agar jumlah karakter yang diisi saat ini (tidak termasuk karakter null penghentian) yang dihitung untuk Anda.

[in] pszSrc

Jenis: PCWSTR

Penunjuk ke string sumber Unicode yang dihentikan null.

Nilai kembali

Jenis: DWORD

Mengembalikan offset karakter null setelah karakter terakhir ditambahkan ke pszDst.

Keterangan

Peringatan Keamanan: Menggunakan fungsi ini salah dapat membahayakan keamanan aplikasi Anda. String akhir tidak dijamin akan dihentikan null. Pertimbangkan untuk menggunakan salah satu alternatif berikut: StringCbCatEx, StringCbCatNEx, StringCchCatEx, atau StringCchCatNEx. Anda harus meninjau Pertimbangan Keamanan: Microsoft Windows Shell sebelum melanjutkan.

Persyaratan

Persyaratan Nilai
Klien minimum yang didukung Windows XP [hanya aplikasi desktop]
Server minimum yang didukung Windows Server 2003 [hanya aplikasi desktop]
Target Platform Windows
Header shlwapi.h
Pustaka Shlwapi.lib
DLL Shlwapi.dll (versi 5.5 atau yang lebih baru)