Fungsi StrNCatW (shlwapi.h)

Artikel
03/02/2024

Menambahkan sejumlah karakter tertentu dari awal satu string ke akhir string lainnya.

Catatan Jangan gunakan fungsi ini atau makro StrCatN . Lihat Keterangan untuk fungsi alternatif.

Sintaks

PWSTR StrNCatW(
  [in, out] PWSTR  psz1,
            PCWSTR psz2,
            int    cchMax
);

Parameter

[in, out] psz1

Jenis: PTSTR

Penunjuk ke string yang dihentikan null tempat fungsi menambahkan karakter dari psz2. Ini harus cukup besar untuk menahan string gabungan ditambah karakter null yang mengakhiri.

psz2

Jenis: PCTSTR

Penunjuk ke string yang dihentikan null untuk ditambahkan.

cchMax

Jenis: int

Jumlah karakter yang akan ditambahkan ke psz1 dari awal psz2.

Nilai kembali

Jenis: PTSTR

Mengembalikan penunjuk ke psz1, yang menyimpan string gabungan.

Keterangan

Peringatan Keamanan: Menggunakan fungsi ini dengan tidak benar dapat membahayakan keamanan aplikasi Anda. Argumen pertama, psz1, harus cukup besar untuk menahan psz2 dan penutupan '\0', jika tidak, overrun buffer dapat terjadi. Overrun buffer dapat menyebabkan penolakan serangan layanan terhadap aplikasi jika pelanggaran akses terjadi. Dalam kasus terburuk, buffer overrun dapat memungkinkan penyerang untuk menyuntikkan kode yang dapat dieksekusi ke dalam proses Anda, terutama jika psz1 adalah buffer berbasis tumpukan. Ketahuilah bahwa argumen terakhir, cchMax, adalah jumlah karakter yang akan disalin ke psz1, belum tentu ukuran psz1 dalam byte. Pertimbangkan untuk menggunakan salah satu alternatif berikut. StringCbCat, StringCbCatEx, StringCbCatN, StringCbCatNEx, StringCchCat, StringCchCatEx, StringCchCatN, atau StringCchCatNEx. Anda harus meninjau Pertimbangan Keamanan: Microsoft Windows Shell sebelum melanjutkan.

Catatan

Header shlwapi.h mendefinisikan StrNCat sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta pra-prosesor UNICODE. Mencampur penggunaan alias encoding-netral dengan kode yang tidak mengodekan-netral dapat menyebabkan ketidakcocokan yang mengakibatkan kesalahan kompilasi atau runtime. Untuk informasi selengkapnya, lihat Konvensi untuk Prototipe Fungsi.

Persyaratan

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

Bagikan melalui