FindResourceEx

Die FindResourceEx -Funktion bestimmt den Speicherort der Ressource mit dem angegebenen Typ, Name und Sprache im angegebenen Modul.

HRSRC FindResourceEx) HMODULE  hModule, / / Ressourcen-Modul handleLPCTSTRlpType, / / Zeiger auf Ressource-TypLPCTSTRlpName, / / Zeiger auf RessourcennameWortwLanguage / / Ressourcensprache ) 

Parameter

hModule

Handle für das Modul, dessen ausführbare Datei die Ressource enthält. Wenn dieser Parameter NULL ist, sucht die Funktion das Modul verwendet, um den aktuellen Prozess erstellen.

lpType

Zeiger auf eine Null-terminierte Zeichenfolge, die Angabe des Typnamens der Ressource. Weitere Informationen finden Sie unter im Abschnitt Hinweise. Für Standardressourcentypen kann dieser Parameter eine der folgenden Werte sein:

Wert	Bedeutung
RT_ACCELERATOR	Zugriffstastentabelle
RT_ANICURSOR	Animierte cursor
RT_ANIICON	Animiertes Symbol
RT_BITMAP	Bitmapressource
RT_CURSOR	Hardware-abhängige Cursor-Ressource
RT_DIALOG	Im Dialogfeld
RT_FONT	Schriftart-Ressource
RT_FONTDIR	Verzeichnis Schriftartressource
RT_GROUP_CURSOR	Hardware-unabhängige Cursor-Ressource
RT_GROUP_ICON	Hardware-unabhängige Symbolressource
RT_HTML	HTML-Dokument
RT_ICON	Hardware-abhängige Symbolressource
RT_MENU	Menüressource
RT_MESSAGETABLE	Nachricht-Tabelleneintrag
RT_RCDATA	Anwendungsdefinierten Ressourcen (Rohdaten)
RT_STRING	Zeichenfolgentabellen-Eintrag
RT_VERSION	Version-Ressource

lpName

Zeiger auf eine auf Null endende Zeichenfolge den Namen der Ressource angibt. Weitere Informationen finden Sie unter im Abschnitt Hinweise.

wLanguage

Gibt die Sprache der Ressource. Wenn dieser Parameter MAKELANGID (LANG_NEUTRAL, SUBLANG_NEUTRAL) ist, wird die aktuelle Sprache dem aufrufenden Thread zugeordnet verwendet.

Um eine anderen Sprache als der aktuellen Sprache anzugeben, verwenden Sie das Makro MAKELANGID um diese Parameter zu erstellen. Weitere Informationen finden Sie unter MAKELANGID.

Rückgabewerte

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für das angegebene Ressource-Infoblock. Um einen Handle auf die Ressource zu erhalten, übergeben Sie dieses Handle an die LoadResource -Funktion.

Wenn die Funktion fehlschlägt, ist der Rückgabewert NULL. Rufen Sie Fehlerinformationen verlängert bekommen, GetLastError.

Bemerkungen

Wenn das hohe Wort des Parameters LpType oder LpName 0 (null) ist, gibt das niedrig-Wort den ganzzahligen Bezeichner des Typs oder der Name der angegebenen Ressource. Andernfalls sind diese Parameter Zeiger auf Null endende Zeichenfolgen. Wenn das erste Zeichen der Zeichenfolge ein Nummernzeichen (#) ist, stellen die verbleibenden Zeichen eine decimal-Zahl, die den ganzzahligen Bezeichner der Namen oder den Typ der Ressource angibt. Beispielsweise stellt die Zeichenfolge "# 258" den ganzzahligen Bezeichner 258.

Anwendungen sollten die Reduzierung der erforderlichen Speicher für die Ressourcen von Ihnen mit einem ganzzahligen Bezeichner statt nach Namen verweisen.

Wenn Sie eine Zugriffstastentabelle, Bitmap, Cursor, Symbol oder Menü benötigen, können Sie seinen zugeordneten Speicher freigeben, indem Sie eine der Funktionen in der folgenden Tabelle.

Das System löscht automatisch diese Ressourcen beim Beenden des Prozesses, der sie erstellt, aber die entsprechende Funktion aufgerufen spart Arbeitsspeicher und reduziert die Größe des Workingsets des Prozesses.

Eine Anwendung kann FindResourceEx verwenden, um jede Art von Ressource zu finden, aber diese Funktion sollte verwendet werden, nur wenn die Anwendung die binären Daten zugreifen muss, wenn nachfolgende Aufrufe an die Funktionen LoadLibrary und LockResource.

Eine Ressource verwenden sollte sofort eine Anwendung die folgenden Ressourcen-spezifische Funktionen zum Suchen und Laden der Ressourcen in einem Aufruf:

Beispielsweise kann eine Anwendung die Funktion LoadIcon verwenden, ein Symbol für die Anzeige auf dem Bildschirm laden. Jedoch sollte die Anwendung FindResourceEx und LoadResource verwenden, wenn es, das Symbol geladen wird, um ihre Daten zu einer anderen Anwendung kopieren.

Zeichenfolgenressourcen sind in Abschnitten von bis zu 16 Strings pro Abschnitt gespeichert. Die Zeichenfolgen in jedem Abschnitt werden als eine Folge von gezählt (nicht Null-terminiert) Unicode-Zeichenfolgen gespeichert. Die LoadString Funktion extrahiert die Zeichenfolgenressource aus den entsprechenden Abschnitt.

QuickInfo

&Nbsp; Windows NT: Version 3.1 oder höher erforderlich.
Windows:Erfordert Windows 95 oder höher.
Windows CE:Nicht unterstützt.
Header:Deklariert in winbase.h.
Importieren Bibliothek:Verwenden Sie kernel32.lib.
Unicode:Als Unicode und ANSI-Versionen auf Windows und Windows NT implementiert.

Siehe auch

Übersicht über Ressourcen, Ressourcen-Funktionen, FormatMessage, LoadAccelerators, LoadBitmap, LoadCursor, LoadIcon LoadMenu, LoadString, LoadResource, MAKELANGID

Index