FindResourceEx

Funksjonen FindResourceEx bestemmer plasseringen av ressursen med den angitte typen, navnet og språket i angitt modul.

() HRSRC FindResourceEx HMODULE  hModule, / / ressurs-modulreferanseLPCTSTRlpType, / / peker til ressurs-typeLPCTSTRlpName, / / peker til ressursnavnWORDwLanguage / / ressurs språk ) 

Parametere

hModule
Håndtere til modulen der kjørbare fil inneholder ressursen. Hvis denne parameteren er NULL, søker funksjonen modulen brukes til å opprette den gjeldende prosessen.
lpType
Pekeren til en null-terminert streng som angir Typenavnet på ressursen. Hvis du vil ha mer informasjon, se under Merknader. For standard ressurstyper, kan denne parameteren være en av følgende verdier:
Verdi Betydning
RT_ACCELERATOR Accelerator tabell
RT_ANICURSOR Animert markør
RT_ANIICON Animerte ikonet
RT_BITMAP Punktgrafikk-ressurs
RT_CURSOR Maskinvareavhengig markøren ressurs
RT_DIALOG Dialogboksen
RT_FONT Skrift-ressurs
RT_FONTDIR Skrift directory-ressursen
RT_GROUP_CURSOR Maskinvare-uavhengig markøren ressurs
RT_GROUP_ICON Maskinvare-uavhengig ikonet ressurs
RT_HTML HTML-dokument
RT_ICON Maskinvareavhengig ikonet ressurs
RT_MENU Menyen ressurs
RT_MESSAGETABLE Oppføring i melding-tabellen
RT_RCDATA Programdefinert ressurs (rådata)
RT_STRING Streng-tabellelementet
RT_VERSION Versjonsressurs

lpName
Pekeren til en null-terminert streng som angir navnet på ressursen. Hvis du vil ha mer informasjon, se under Merknader.
wLanguage
Angir språket for ressursen. Hvis denne parameteren er MAKELANGID (LANG_NEUTRAL, SUBLANG_NEUTRAL), brukes gjeldende språk knyttet til kallende tråden.

Hvis du vil angi et annet språk enn det gjeldende språket, kan du bruke makroen MAKELANGID til å opprette denne parameteren. Hvis du vil ha mer informasjon, se MAKELANGID.

Returverdier

Hvis funksjonen lykkes, er returverdien en referanse til den angitte ressursen informasjonsblokk. Hvis du vil hente en referanse til ressursen, kan du sende denne referansen til LoadResource -funksjonen.

Hvis funksjonen mislykkes, er verdien som returneres NULL. Til å vise utvidet feilinformasjon, kan du ringe GetLastError.

Merknader

Hvis høy-ordet for parameteren lpType eller lpName er null, angir underordet heltall-identifikator for typen eller navnet på en gitt ressurs. Ellers er disse parameterne pekere til null-terminert strenger. Hvis det første tegnet i strengen er et nummertegn (#), representerer gjenværende tegnene et desimaltall som angir identifikatoren heltall til ressursens navnet eller typen. Strengen "# 258" representerer for eksempel heltall identifikatoren 258.

Programmer bør redusere mengden minne som kreves for ressurser ved å referere til dem av heltall identifikator i stedet for etter navn.

Når du er ferdig med å bruke en accelerator tabell, punktgrafikk, markøren, ikon eller menyen, kan du frigi tilknyttede minnet av en av funksjonene i følgende tabell.

Ressurs Release-funksjonen
Accelerator tabell DestroyAcceleratorTable
Punktgrafikk SlettObjekt
Markøren DestroyCursor
Ikonet DestroyIcon
Menyen DestroyMenu

Systemet sletter automatisk disse ressursene når du avslutter prosessen som opprettet dem, men kaller den relevante funksjonen sparer du minne, og reduserer størrelsen på prosessens arbeidssett.

Et program kan bruke FindResourceEx til å finne alle typer ressurs, men denne funksjonen bør bare brukes hvis programmet må få tilgang til binære ressursdataene når du foretar etterfølgende kall til den funksjonene LoadLibrary - og LockResource.

For å bruke en ressurs umiddelbart, et program bør ha bruke følgende ressurs-spesifikke funksjoner til å finne og laste ressurser i ett anrop:

Funksjonen Handling
FormatMessage Laster inn og formaterer en oppføring i melding-tabellen.
LoadAccelerators Laster en Web Slice-tabellen.
LoadBitmap Laster en punktgrafikk-ressurs.
LoadCursor Laster en markør-ressurs.
LoadIcon Laster en ikon-ressurs.
LoadMenu Laster en menyen-ressurs.
Finner Laster inn en oppføring i streng-tabellen.

Et program kan for eksempel bruke funksjonen LoadIcon for å laste et ikon for visning på skjermen. Men bør programmet bruke FindResourceEx og LoadResource Hvis det er lasting ikonet for å kopiere data til et annet program.

Strengressurser for lagres i inndelinger med opptil 16 strenger per inndeling. Strengene i hver inndeling lagres som en sekvens av opptalte (ikke null-terminert) Unicode-strenger. Den finner funksjonen vil trekke ut strengen ressursen fra den tilsvarende delen.

Hurtiginformasjon

nbsp; Windows &NT: krever versjon 3.1 eller senere.
Windows:Krever Windows 95 eller senere.
Windows CE:Som ikke støttes.
Topptekst:Deklarert i winbase.h.
Importere biblioteket:Bruk kernel32.lib.
Unicode:Implementert som Unicode- og ANSI-versjoner i Windows og Windows NT.

Se også

Oversikt over ressurser, ressurs funksjoner, FormatMessage, LoadAccelerators, LoadBitmap, LoadCursor, LoadIcon, LoadMenu, finner, LoadResource, MAKELANGID

Index