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.

Resource Release-functie
Accelerator tabel DestroyAcceleratorTable
Bitmap ObjectVerwijderen (DeleteObject)
Cursor DestroyCursor
Pictogram DestroyIcon
Menu DestroyMenu

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:

Functie Actie
FormatMessage Ladingen en een bericht-lijstingang formaten.
LoadAccelerators Ladingen een versneller tabel.
LoadBitmap Een bitmapbron ladingen.
LoadCursor Ladingen een cursor resource.
LoadIcon Ladingen een pictogram resource.
LoadMenu Ladingen een menu resource.
LoadString Een tekenreeks-lijstingang ladingen.

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