Fungsi LoadStringA (winuser.h)

Artikel
11/20/2024

Memuat sumber daya string dari file yang dapat dieksekusi yang terkait dengan modul tertentu dan menyalin string ke dalam buffer dengan karakter null yang mengakhiri atau mengembalikan penunjuk baca-saja ke sumber daya string itu sendiri.

Sintaksis

int LoadStringA(
  [in, optional] HINSTANCE hInstance,
  [in]           UINT      uID,
  [out]          LPSTR     lpBuffer,
  [in]           int       cchBufferMax
);

Parameter

[in, optional] hInstance

Jenis: HINSTANCE

Handel ke instans modul yang file yang dapat dieksekusi berisi sumber daya string. Untuk mendapatkan handel ke aplikasi itu sendiri, panggil fungsi GetModuleHandle dengan NULL.

[in] uID

Jenis: UINT

Pengidentifikasi string yang akan dimuat.

[out] lpBuffer

Jenis: LPTSTR

Buffer untuk menerima string. Setidaknya harus karakter cchBufferMax.

[in] cchBufferMax

Jenis: int

Ukuran buffer, dalam karakter. String dipotong dan dihentikan null jika lebih panjang dari jumlah karakter yang ditentukan. Parameter ini mungkin bukan nol.

Mengembalikan nilai

Jenis: int

Jika fungsi berhasil, nilai pengembalian adalah jumlah karakter yang disalin ke dalam buffer, tidak termasuk karakter null yang mengakhiri.

Jika sumber daya string tidak ada, nilai yang dikembalikan adalah nol.

Untuk mendapatkan informasi kesalahan yang diperluas, panggil GetLastError.

Komentar

Tidak seperti fungsi LoadStringW , fungsi LoadStringA tidak mendukung melewati nilai nol untuk cchBufferMax. Melakukannya akan merusak memori.

Keterangan Keamanan

Menggunakan fungsi ini salah dapat membahayakan keamanan aplikasi Anda. Penggunaan yang salah termasuk menentukan ukuran yang salah dalam parameter cchBufferMax. Misalnya, jika lpBuffer menunjuk ke buffer szBuffer yang dinyatakan sebagai TCHAR szBuffer[100], maka sizeof(szBuffer) memberikan ukuran buffer dalam byte, yang dapat menyebabkan luapan buffer untuk versi Fungsi Unicode. Situasi luapan buffer adalah penyebab banyak masalah keamanan dalam aplikasi. Dalam hal ini, menggunakan sizeof(szBuffer)/sizeof(TCHAR) atau sizeof(szBuffer)/sizeof(szBuffer[0]) akan memberikan ukuran buffer yang tepat.

Contoh

Misalnya, lihat Membuat Jendela Anak

Nota

Header winuser.h mendefinisikan LoadString sebagai alias yang secara otomatis memilih versi ANSI atau Unicode dari fungsi ini berdasarkan definisi konstanta preprosedur 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 [hanya aplikasi desktop]
server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Platform Target	Windows
Header	winuser.h (termasuk Windows.h)
Pustaka	User32.lib
DLL	User32.dll

Lihat juga

Konseptual

FormatMessage

LoadAccelerators

LoadBitmap

LoadCursor

LoadIcon

LoadMenu

LoadMenuIndirect

Sumber Daya Lain

Referensi

String

Bagikan melalui