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.

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:

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