Fungsi LoadCursorFromFileA (winuser.h)

Artikel
03/13/2024

Membuat kursor berdasarkan data yang terkandung dalam file.

Catatan

Fungsi ini telah digantikan oleh fungsi LoadImage (dengan bendera LR_DEFAULTSIZE dan LR_LOADFROMFILE diatur).

Sintaks

HCURSOR LoadCursorFromFileA(
  [in] LPCSTR lpFileName
);

Parameter

[in] lpFileName

Jenis: LPCTSTR

Sumber data file yang akan digunakan untuk membuat kursor. Data dalam file harus berada di salah satu . CUR atau . Format ANI.

Jika kata urutan tinggi dari lpFileName bukan nol, itu adalah penunjuk ke string yang merupakan nama file yang sepenuhnya memenuhi syarat yang berisi data kursor.

Mengembalikan nilai

Jenis: HCURSOR

Jika fungsi berhasil, nilai yang dikembalikan adalah handel ke kursor baru.

Jika fungsi gagal, nilai yang dikembalikan adalah NULL. Untuk mendapatkan informasi kesalahan yang diperluas, hubungi GetLastError. GetLastError dapat mengembalikan nilai berikut.

Menampilkan kode	Deskripsi
ERROR_FILE_NOT_FOUND	File yang ditentukan tidak dapat ditemukan.

Keterangan

Virtualisasi DPI

API ini tidak berpartisipasi dalam virtualisasi DPI. Output yang dikembalikan tidak terpengaruh oleh DPI dari utas panggilan.

Catatan

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