Fungsi StrNCatA (shlwapi.h)

Artikel
08/26/2023

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

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

Sintaks

PSTR StrNCatA(
  [in, out] PSTR  psz1,
            PCSTR 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.

Menampilkan nilai

Jenis: PTSTR

Mengembalikan penunjuk ke psz1, yang menyimpan string gabungan.

Keterangan

Peringatan Keamanan: Menggunakan fungsi ini salah dapat membahayakan keamanan aplikasi Anda. Argumen pertama, psz1, harus cukup besar untuk menahan psz2 dan penutupan '\0', jika tidak, overrun buffer dapat terjadi. Buffer overruns 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 praproscessor 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


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