FindResourceA-Funktion (winbase.h)
Bestimmt den Speicherort einer Ressource mit dem angegebenen Typ und Namen im angegebenen Modul.
Um eine Sprache anzugeben, verwenden Sie die FindResourceEx-Funktion .
Syntax
HRSRC FindResourceA(
[in, optional] HMODULE hModule,
[in] LPCSTR lpName,
[in] LPCSTR lpType
);
Parameter
[in, optional] hModule
Typ: HMODULE
Ein Handle für das Modul, dessen portable ausführbare Datei oder eine zugehörige MUI-Datei die Ressource enthält. Wenn dieser Parameter NULL ist, durchsucht die Funktion das Modul, das zum Erstellen des aktuellen Prozesses verwendet wird.
[in] lpName
Typ: LPCTSTR
Der Name der Ressource. Alternativ kann dieser Parameter anstelle eines Zeigers MAKEINTRESOURCE(ID) sein, wobei ID der ganzzahlige Bezeichner der Ressource ist. Weitere Informationen finden Sie weiter unten im Abschnitt Hinweise.
[in] lpType
Typ: LPCTSTR
Der Ressourcentyp. 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.
Rückgabewert
Typ: HRSRC
Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Handle für den Informationsblock der angegebenen Ressource. Um ein Handle für die Ressource abzurufen, übergeben Sie dieses Handle an die LoadResource-Funktion .
Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.
Hinweise
Wenn IS_INTRESOURCE für x = lpName oder lpTypeTRUE ist, gibt x den ganzzahligen Bezeichner des Namens oder Typs der angegebenen Ressource an. Andernfalls sind diese Parameter lange Zeiger auf NULL-beendete Zeichenfolgen. Wenn das erste Zeichen der Zeichenfolge ein Pfundzeichen (#) ist, stellen die restlichen Zeichen eine Dezimalzahl dar, die den ganzzahligen Bezeichner des Namens oder Typs der Ressource angibt. Die Zeichenfolge "#258" stellt beispielsweise den ganzzahligen Bezeichner 258 dar.
Um den für eine Ressource erforderlichen Arbeitsspeicher zu reduzieren, sollte eine Anwendung mit ganzzahligem Bezeichner anstelle des Namens darauf verweisen.
Eine Anwendung kann FindResource verwenden, um einen beliebigen Ressourcentyp zu finden. Diese Funktion sollte jedoch nur verwendet werden, wenn die Anwendung auf die binären Ressourcendaten zugreifen muss, indem sie anschließend LoadResource und dann LockResource aufruft.
Um eine Ressource sofort zu verwenden, sollte eine Anwendung eine der folgenden ressourcenspezifischen Funktionen verwenden, um die Ressource zu finden und die Daten in eine verwendbarere Form zu konvertieren.
Funktion | Aktion |
---|---|
FormatMessage | Lädt und formatiert einen Nachrichtentabelleneintrag. |
LoadAccelerators | Lädt eine Acceleratortabelle. |
LoadBitmap | Lädt eine Bitmapressource. |
LoadCursor | Lädt eine Cursorressource. |
LoadIcon | Lädt eine Symbolressource. |
LoadMenu | Lädt eine Menüressource. |
LoadString | Lädt einen Zeichenfolgentabelleneintrag. |
Beispielsweise kann eine Anwendung die LoadIcon-Funktion verwenden, um ein Symbol für die Anzeige auf dem Bildschirm zu laden. Die Anwendung sollte jedoch FindResource und LoadResource verwenden, wenn sie das Symbol lädt, um ihre Daten in eine andere Anwendung zu kopieren.
Zeichenfolgenressourcen werden in Abschnitten mit bis zu 16 Zeichenfolgen pro Abschnitt gespeichert. Die Zeichenfolgen in jedem Abschnitt werden als Sequenz von gezählten Unicode-Zeichenfolgen (nicht unbedingt null-beendet) gespeichert. Die LoadString-Funktion extrahiert die Zeichenfolgenressource aus dem entsprechenden Abschnitt.
Beispiele
Ein Beispiel finden Sie unter Aktualisieren von Ressourcen.
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 | winbase.h (einschließlich Windows.h) |
Bibliothek | Kernel32.lib |
DLL | Kernel32.dll |
Siehe auch
Konzept
Andere Ressourcen
Referenz