FindResource

De FindResource functie bepaalt de locatie van een resource met het opgegeven type en de naam in de opgegeven module.

HRSRC FindResource) HMODULE  hModule, / / module verwerkenLPCTSTRlpName, / / pointer naar ResourcenaamLPCTSTRlpType / / pointer naar resource type);
 

Parameters

hModule

Ingang naar de module waarvan het uitvoerbare bestand de resource bevat.

Een waarde van NULL de bestandsingang module die is gekoppeld aan het afbeeldingsbestand waarmee het besturingssysteem gemaakt het huidige proces.

lpName

Hiermee geeft u de naam van de resource. Voor meer informatie, zie de sectie opmerkingen.

lpType

Hiermee geeft u het resourcetype. 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

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 eersterangs woord van de lpName of lpType parameter nul is, geeft de lage-orde woord het geheel getal als id voor de naam of het type van de gegeven resource. Deze parameters zijn anders, lange 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.

Een toepassing moet de vereiste hoeveelheid geheugen voor de resources door te verwijzen naar hen door geheel getal als id in plaats van met de naam verminderen.

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 FindResource 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 LoadLibrary en LockResource.

Een bron gebruikt onmiddellijk, een toepassing moet gebruiken een van 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 FindResource 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.

Windows CE: De parameter hModule niet kan worden een NULL handvat.

De parameter lpName biedt geen ondersteuning voor de resource-ID nul — dat wil zeggen, FindResource (h, 0, t) werkt niet zoals verwacht.

De RT_ANICURSOR of RT_ANIICON waarden, kunt u niet overgaan in de parameter lpType .

Syntaxisinfo

nbsp; Windows &NT: versie 3.1 of hoger vereist.
Windows:Windows 95 of hoger vereist.
Windows CE:Versie 1.0 of hoger vereist.
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 functioneert, FindResourceEx, FormatMessage, LoadAccelerators, LoadBitmap, LoadCursor, LoadIcon, LoadMenu, LoadResource, LoadString, LockResource, SizeofResource

Index