Fungsi StrNCatA (shlwapi.h)

Artikel
11/20/2024

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.

Sintaksis

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 null-terminated yang akan ditambahkan.

cchMax

Jenis: int

Jumlah karakter yang akan ditambahkan ke psz1 dari awalpsz2 .

Mengembalikan nilai

Jenis: PTSTR

Mengembalikan pointer ke psz1, yang menyimpan string gabungan.

Komentar

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. Overruns buffer dapat menyebabkan penolakan serangan layanan terhadap aplikasi jika terjadi pelanggaran akses. 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.

Nota

Header shlwapi.h mendefinisikan StrNCat sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosektor 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

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

Bagikan melalui