Fungsi lstrcpyA (winbase.h)

Artikel
03/08/2023

Menyalin string ke buffer.

Peringatan Jangan gunakan. Pertimbangkan untuk menggunakan StringCchCopy sebagai gantinya. Lihat Keterangan.

Sintaks

LPSTR lstrcpyA(
  [out] LPSTR  lpString1,
  [in]  LPCSTR lpString2
);

Parameter

[out] lpString1

Jenis: LPTSTR

Buffer untuk menerima konten string yang ditujukkan oleh parameter lpString2 . Buffer harus cukup besar untuk berisi string, termasuk karakter null yang mengakhiri.

[in] lpString2

Jenis: LPTSTR

String null-terminated yang akan disalin.

Nilai kembali

Jenis: LPTSTR

Jika fungsi berhasil, nilai yang dikembalikan adalah penunjuk ke buffer.

Jika fungsi gagal, nilai yang dikembalikan adalah NULL dan lpString1 mungkin tidak dihentikan null.

Keterangan

Dengan versi set karakter byte ganda (DBCS) sistem, fungsi ini dapat digunakan untuk menyalin string DBCS.

Fungsi lstrcpy memiliki perilaku yang tidak terdefinisi jika buffer sumber dan tujuan tumpang tindih.

Keterangan Keamanan

Menggunakan fungsi ini salah dapat membahayakan keamanan aplikasi Anda. Fungsi ini menggunakan penanganan pengecualian terstruktur (SEH) untuk menangkap pelanggaran akses dan kesalahan lainnya. Ketika fungsi ini menangkap kesalahan SEH, fungsi ini mengembalikan NULL tanpa menghentikan string null dan tanpa memberi tahu pemanggil kesalahan. Pemanggil tidak aman untuk mengasumsikan bahwa ruang yang tidak mencukup adalah kondisi kesalahan.

lpString1 harus cukup besar untuk menahan lpString2 dan penutupan '\0', jika tidak, overrun buffer dapat terjadi.

Situasi luapan buffer adalah penyebab banyak masalah keamanan dalam aplikasi dan 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 lpString1 adalah buffer berbasis tumpukan.

Pertimbangkan untuk menggunakan StringCchCopy sebagai gantinya; gunakan , StringCchCopy(buffer, sizeof(buffer)/sizeof(buffer[0]), src);menyadari bahwa buffer tidak boleh menjadi penunjuk atau menggunakan StringCchCopy(buffer, ARRAYSIZE(buffer), src);, menyadari bahwa, saat menyalin ke penunjuk, pemanggil bertanggung jawab untuk meneruskan ukuran memori yang diarahkan ke karakter.

Catatan

Header winbase.h mendefinisikan lstrcpy 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


Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	winbase.h (termasuk Windows.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll