LoadCursorFromFileA-Funktion (winuser.h)

Artikel
08/08/2024

Erstellt einen Cursor basierend auf Daten, die in einer Datei enthalten sind.

Hinweis

Diese Funktion wurde durch die LoadImage-Funktion abgelöst (mit LR_DEFAULTSIZE und LR_LOADFROMFILE Flags festgelegt).

Syntax

HCURSOR LoadCursorFromFileA(
  [in] LPCSTR lpFileName
);

Parameter

[in] lpFileName

Typ: LPCTSTR

Die Quelle der Dateidaten, die zum Erstellen des Cursors verwendet werden sollen. Die Daten in der Datei müssen sich in beiden befinden. CUR oder . ANI-Format.

Wenn das Wort mit hoher Ordnung von lpFileName ungleich null ist, handelt es sich um einen Zeiger auf eine Zeichenfolge, die einen vollqualifizierten Namen einer Datei mit Cursordaten darstellt.

Rückgabewert

Typ: HCURSOR

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für den neuen Cursor.

Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf. GetLastError gibt möglicherweise den folgenden Wert zurück.

Rückgabecode	Beschreibung
ERROR_FILE_NOT_FOUND	Die angegebene Datei kann nicht gefunden werden.

Hinweise

DPI-Virtualisierung

Diese API ist nicht an der DPI-Virtualisierung beteiligt. Die zurückgegebene Ausgabe wird vom DPI-Wert des aufrufenden Threads nicht beeinflusst.

Hinweis

Der winuser.h-Header definiert LoadCursorFromFile als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (windows.h einschließen)
Bibliothek	User32.lib
DLL	User32.dll