ENUMRESNAMEPROCW-Rückruffunktion (libloaderapi.h)

Artikel
08/24/2023

Eine anwendungsdefinierte Rückruffunktion, die mit den Funktionen EnumResourceNames und EnumResourceNamesEx verwendet wird. Er empfängt den Typ und namen einer Ressource. Der ENUMRESNAMEPROC-Typ definiert einen Zeiger auf diese Rückruffunktion. EnumResNameProc ist ein Platzhalter für den anwendungsdefinierte Funktionsnamen.

Syntax

ENUMRESNAMEPROCW Enumresnameprocw;

BOOL Enumresnameprocw(
  [in, optional] HMODULE hModule,
                 LPCWSTR lpType,
                 LPWSTR lpName,
  [in]           LONG_PTR lParam
)
{...}

Parameter

[in, optional] hModule

Typ: HMODULE

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

lpType

Typ: LPCTSTR

Der Typ der Ressource, für die der Name aufgezählt wird. Alternativ kann dieser Parameter anstelle eines Zeigers sein MAKEINTRESOURCE(ID), wobei ID ein ganzzahliger Wert ist, der einen vordefinierten Ressourcentyp darstellt. Informationen zu Standardressourcentypen finden Sie unter Ressourcentypen. Weitere Informationen finden Sie weiter unten im Abschnitt "Hinweise".

lpName

Typ: LPTSTR

Der Name einer Ressource des Typs, der aufgezählt wird. Alternativ kann dieser Parameter anstelle eines Zeigers sein MAKEINTRESOURCE(ID), wobei ID der ganzzahlige Bezeichner der Ressource ist. Weitere Informationen finden Sie weiter unten im Abschnitt "Hinweise".

[in] lParam

Typ: LONG_PTR

Ein anwendungsdefinierter Parameter, der an die Funktion EnumResourceNames oder EnumResourceNamesEx ü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.

Wenn IS_INTRESOURCE(lpszName) auf TRUE festgelegt ist, gibt lpszName den ganzzahligen Bezeichner der angegebenen Ressource 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 der Ressource angibt.

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

Wenn die Rückruffunktion FALSE zurückgibt, wird die Enumeration durch EnumResourceNames oder EnumResourceNamesEx 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 ENUMRESNAMEPROC 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)