LoadCursorFromFileA-Funktion (winuser.h)

Artikel
11/20/2024

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

Anmerkung

Diese Funktion wurde durch die LoadImage-Funktion ersetzt (wobei LR_DEFAULTSIZE und LR_LOADFROMFILE Flags festgelegt sind).

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 hochgeordnete Wort von lpFileName ungleich Null ist, ist es ein 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 die Funktion fehlschlägt, ist der Rückgabewert NULL-. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen zu erhalten. GetLastError- kann den folgenden Wert zurückgeben.

Rückgabecode	Beschreibung
ERROR_FILE_NOT_FOUND	Die angegebene Datei wurde nicht gefunden.

Bemerkungen

DPI-Virtualisierung

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

Anmerkung

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
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows 2000 Server [nur Desktop-Apps]
Zielplattform-	Fenster
Header-	winuser.h (enthalten Windows.h)
Library	User32.lib
DLL-	User32.dll