FindResourceEx

De FindResourceEx functie bepaalt de locatie van de resource met het opgegeven type, naam, en taal in de opgegeven module.

HRSRC FindResourceEx) HMODULE  hModule, / / resource-module verwerkenLPCTSTRlpType, / / pointer naar resource typeLPCTSTRlpName, / / pointer naar ResourcenaamWORDwLanguage / / resource taal ) 

Parameters

hModule

Ingang naar de module waarvan het uitvoerbare bestand de resource bevat. Als deze parameter NULL is, zoekt de functie de module gebruikt voor het maken van het huidige proces.

lpType

Aanwijzer naar een op null eindigende tekenreeks de naam van de resource opgeven. Zie opmerkingen voor meer informatie. Standaardbrontypen, voor kan deze parameter een van de volgende waarden worden:

Waarde	Betekenis
RT_ACCELERATOR	Accelerator tabel
RT_ANICURSOR	Bewegende cursor
RT_ANIICON	Geanimeerde pictogram
RT_BITMAP	Bitmapbron
RT_CURSOR	Hardwareafhankelijke cursor resource
RT_DIALOG	Het dialoogvenster
RT_FONT	Font resource
RT_FONTDIR	Lettertype directory resource
RT_GROUP_CURSOR	Hardware-onafhankelijke cursor resource
RT_GROUP_ICON	Hardware-onafhankelijke pictogram resource
RT_HTML	HTML-document
RT_ICON	Hardwareafhankelijke pictogram resource
RT_MENU	Menu resource
RT_MESSAGETABLE	Bericht-lijstingang
RT_RCDATA	Toepassing gedefinieerde resource (ruwe gegevens)
RT_STRING	Tekenreeks-lijstingang
RT_VERSION	Versie resource

lpName

Aanwijzer naar een op null eindigende tekenreeks de naam van de resource opgeven. Voor meer informatie, zie de sectie opmerkingen.

wLanguage

Hiermee geeft u de taal van de resource. Als deze parameter is MAKELANGID (LANG_NEUTRAL, SUBLANG_NEUTRAL), de huidige taal die is gekoppeld aan de aanroepende draad gebruikt.

Gebruik de macro MAKELANGID maken deze parameter te geven een andere taal dan de huidige taal. Voor meer informatie, Zie MAKELANGID.

Retourwaarden

Als de functie slaagt, is de retourwaarde een handvat aan de opgegeven resource Infoblok. Een handvat om de bron te verkrijgen, geef dit handvat aan de functie LoadResource.

Als de functie mislukt, is de retourwaarde NULL. Te krijgen uitgebreide foutinformatie, Bel GetLastError.

Opmerkingen

Als de hoge-woord van de lpType of lpName parameter nul is, geeft de lage-word de geheel getal als id voor het type of de naam van de gegeven resource. Deze parameters zijn anders, wijzers aan koorden is eindigt met null. Als het eerste teken van de tekenreeks een hekje (#), vertegenwoordigen de overige tekens een decimale getal dat het geheel getal als id voor de naam of het type van de resource aangeeft. Bijvoorbeeld vertegenwoordigt de tekenreeks "# 258" het geheel getal als id 258.

Toepassingen moeten verminderen de hoeveelheid geheugen die nodig zijn voor de middelen door te verwijzen naar hen door geheel getal als id in plaats van met de naam.

Wanneer u klaar met een versneller tabel, bitmap, cursor, pictogram of menu bent, kunt u de bijbehorende geheugen vrijgeven door te bellen naar een van de functies in de volgende tabel.

Het systeem automatisch verwijdert deze bronnen wanneer eindigt het proces waardoor ze zijn gemaakt, echter de juiste functie bespaart geheugen en vermindert de grootte van de werkset van het proces.

Een toepassing kan gebruiken FindResourceEx om te vinden elk type resource, maar deze functie moet alleen worden gebruikt als de toepassing moet toegang hebben tot de binaire Resourcegegevens het daaropvolgende aanroepen de functies LoadLibrary en LockResource.

Een bron gebruikt onmiddellijk, een toepassing moet gebruiken de volgende resource-specifieke functies te vinden en laden de middelen in een oproep:

Een toepassing kan bijvoorbeeld de functie LoadIcon gebruiken om te laden van een pictogram voor weergave op het scherm. Echter moet de toepassing FindResourceEx en LoadResource gebruiken als het het pictogram zijn gegevens kopiëren naar een andere toepassing wordt geladen.

Tekenreeks middelen worden opgeslagen in secties van maximaal 16 tekenreeksen per sectie. De snaren in elke sectie worden opgeslagen als een sequentie van getelde (niet null eindigende) Unicode-tekenreeksen. De LoadString functie de tekenreeks resource zal uittreksel uit haar overeenkomstige sectie.

Syntaxisinfo

nbsp; Windows &NT: versie 3.1 of hoger vereist.
Windows:Windows 95 of hoger vereist.
Windows CE:Niet-ondersteunde.
Header:Verklaard in winbase.h.
Bibliotheek importeren:Kernel32.lib gebruiken.
Unicode:Geïmplementeerd als Unicode en ANSI-versies van Windows en Windows NT.

Zie ook

Bronnen overzicht, Resource functies, FormatMessage, LoadAccelerators, LoadBitmap, LoadCursor, LoadIcon, LoadMenu, LoadString, LoadResource, MAKELANGID

Index