UpdateResource

Funksjonen UpdateResource legger til, sletter eller erstatter en ressurs i en kjørbar fil.

() BOOL UpdateResource HÅNDTERE  hUpdate, / / -oppdateringsfilen håndtereLPCTSTRlpType, / / skriver du inn adressen til ressursen du vil oppdatereLPCTSTRlpName, / / adressen til ressursen navn for å oppdatereWORDwLanguage, / / språk-ID for ressursLPVOIDlpData, / / adresse av ressursdataDWORDcbData / / lengden på ressursdata, i byte);
 

Parametere

hUpdate
Angir en oppdatering filreferanse. Denne referansen som returneres av funksjonen BeginUpdateResource.
lpType
Pekeren til en null-terminert streng som å angi ressurstypen som skal oppdateres. Denne parameteren kan også være en heltallsverdi som ble sendt til MAKEINTRESOURCE -makro, eller det kan være en av følgende forhåndsdefinerte ressurstyper:
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 som skal oppdateres. Denne parameteren kan også være en heltallsverdi som ble sendt til MAKEINTRESOURCE -makro.
wLanguage
Angir språkidentifikatoren til ressursen skal oppdateres. En liste over hovedspråket identifikatorer og et Sidespråk identifikatorer som utgjør en språk-ID, kan du se den MAKELANGID makro.
lpData
Pekeren til ressursdata settes inn i den kjørbare filen. Hvis ressursen er en av de forhåndsdefinerte typene, må dataene være gyldig og riktig justert. Merk at dette er den rå, binære data som er lagret i den kjørbare filen, ikke data fra LoadIcon, finnereller andre belastningen av ressurs-spesifikke funksjoner. Alle data som inneholder strenger eller teksten må være i Unicode-format; lpData må ikke peke til ANSI-data.

Hvis lpData er NULL, er den angitte ressursen slettet fra den kjørbare filen.

cbData
Angir størrelsen, i byte, på ressursdata på lpData.

Returverdier

Hvis funksjonen lykkes, er returverdien ikke-null.

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

Merknader

Et program kan bruke UpdateResource gjentatte ganger til å gjøre endringer i ressursdataene. Hvert kall til UpdateResource bidrar til en intern liste over tillegg, slettinger og erstatninger, men faktisk skriver ikke data til den kjørbare filen. Programmet må bruke EndUpdateResource -funksjonen til å skrive akkumulerte endringene til den kjørbare filen.

Hurtiginformasjon

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

Se også

Oversikt over ressurser ressurs fungerer, BeginUpdateResource, EndUpdateResource, LoadIcon, finner, LockResource, MAKEINTRESOURCE, MAKELANGID, SizeofResource

Index