ENUMRESTYPEPROCA-Rückruffunktion (libloaderapi.h)

Artikel
08/24/2023

Eine anwendungsdefinierte Rückruffunktion, die mit den Funktionen EnumResourceTypes und EnumResourceTypesEx verwendet wird. Es empfängt Ressourcentypen. Der ENUMRESTYPEPROC-Typ definiert einen Zeiger auf diese Rückruffunktion. EnumResTypeProc ist ein Platzhalter für den anwendungsdefinierte Funktionsnamen.

Syntax

ENUMRESTYPEPROCA Enumrestypeproca;

BOOL Enumrestypeproca(
  [in, optional] HMODULE hModule,
                 LPSTR lpType,
  [in]           LONG_PTR lParam
)
{...}

Parameter

[in, optional] hModule

Typ: HMODULE

Ein Handle für das Modul, dessen ausführbare Datei die Ressourcen enthält, für die die Typen aufgezählt werden sollen. Wenn dieser Parameter NULL ist, listet die Funktion die Ressourcentypen in dem Modul auf, das zum Erstellen des aktuellen Prozesses verwendet wird.

lpType

Typ: LPTSTR

Der Typ der Ressource, für die der Typ aufgezählt wird.

Alternativ kann dieser Parameter anstelle eines Zeigers MAKEINTRESOURCE(ID) sein, wobei ID der ganzzahlige Bezeichner des angegebenen Ressourcentyps ist. Informationen zu Standardressourcentypen finden Sie unter Ressourcentypen. Weitere Informationen finden Sie weiter unten im Abschnitt "Hinweise".

[in] lParam

Typ: LONG_PTR

Ein anwendungsdefinierter Parameter, der an die Funktion EnumResourceTypes oder EnumResourceTypesEx übergeben wird. Dieser Parameter kann bei der Fehlerüberprüfung verwendet werden.

Rückgabewert

Typ: BOOL

Gibt TRUE zurück, um die Enumeration fortzusetzen, oder FALSE , um die Enumeration zu beenden.

Hinweise

Wenn IS_INTRESOURCE(lpszType) TRUE ist, gibt lpszType den ganzzahligen Bezeichner des angegebenen Ressourcentyps an. Andernfalls handelt es sich um einen Zeiger auf eine NULL-endende Zeichenfolge. Wenn das erste Zeichen der Zeichenfolge ein Pfundzeichen (#) ist, stellen die verbleibenden Zeichen eine Dezimalzahl dar, die den ganzzahligen Bezeichner des Ressourcentyps angibt. Die Zeichenfolge "#258" stellt beispielsweise den Bezeichner 258 dar.

Eine Anwendung muss diese Funktion registrieren, indem sie ihre Adresse an die Funktion EnumResourceTypes oder EnumResourceTypesEx übergibt.

Wenn die Rückruffunktion FALSE zurückgibt, wird die Enumeration von EnumResourceTypes oder EnumResourceTypesEx beendet und FALSE zurückgegeben. Unter Windows XP und früheren Versionen wird der von GetLastError abgerufene Wert ERROR_SUCCESS. Ab Windows Vista wird der letzte Fehlerwert ERROR_RESOURCE_ENUM_USER_STOP.

Hinweis

Der libloaderapi.h-Header definiert ENUMRESTYPEPROC 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


Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	libloaderapi.h (Einschließen von Windows.h)