ENUMRESTYPEPROCW-Rückruffunktion (libloaderapi.h)

Artikel
08/24/2023

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

Syntax

ENUMRESTYPEPROCW Enumrestypeprocw;

BOOL Enumrestypeprocw(
  [in, optional] HMODULE hModule,
                 LPWSTR 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 aufgelistet werden sollen. Wenn dieser Parameter NULL ist, listet die Funktion die Ressourcentypen im Modul auf, das zum Erstellen des aktuellen Prozesses verwendet wird.

lpType

Typ: LPTSTR

Der Ressourcentyp, für den der Typ aufgelistet wird.

Alternativ kann dieser Parameter anstelle eines Zeigers MAKEINTRESOURCE(ID) sein, wobei ID der ganzzahlige Bezeichner des angegebenen Ressourcentyps ist. 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-Zeichenfolge. Wenn das erste Zeichen der Zeichenfolge ein Pfundzeichen (#) ist, stellen die restlichen 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 automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit nicht codierungsneutralem Code 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	libloaderapi.h (einschließlich Windows.h)