Funzione LoadCursorFromFileA (winuser.h)

Articolo
03/04/2024

Crea un cursore basato sui dati contenuti in un file.

Nota

Questa funzione è stata sostituita dalla funzione LoadImage (con LR_DEFAULTSIZE e LR_LOADFROMFILE flag impostati).

Sintassi

HCURSOR LoadCursorFromFileA(
  [in] LPCSTR lpFileName
);

Parametri

[in] lpFileName

Tipo: LPCTSTR

Origine dei dati del file da utilizzare per creare il cursore. I dati nel file devono trovarsi in . CUR o . Formato ANI.

Se la parola di ordine elevato di lpFileName è diversa da zero, si tratta di un puntatore a una stringa che rappresenta un nome completo di un file contenente i dati del cursore.

Valore restituito

Tipo: HCURSOR

Se la funzione ha esito positivo, il valore restituito è un handle per il nuovo cursore.

Se la funzione ha esito negativo, il valore restituito è NULL. Per informazioni dettagliate sull'errore, chiamare GetLastError. GetLastError può restituire il valore seguente.

Codice restituito	Descrizione
ERROR_FILE_NOT_FOUND	Impossibile trovare il file specificato.

Commenti

Virtualizzazione DPI

Questa API non partecipa alla virtualizzazione DPI. L'output restituito non è interessato dal valore DPI del thread chiamante.

Nota

L'intestazione winuser.h definisce LoadCursorFromFile come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice che non è indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzioni.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll