UpdateResource

La funzione UpdateResource aggiunge, elimina o sostituisce una risorsa in un file eseguibile.

(BOOL UpdateResource GESTIRE  hUpdate, / / handle di file di aggiornamentoLPCTSTRlpType, / / tipo di indirizzo della risorsa per l'aggiornamentoLPCTSTRlpName, / / nome dell'indirizzo di risorsa per l'aggiornamentoWORDwLanguage, / / identificatore di lingua della risorsaLPVOIDlpData, / / indirizzo dei dati delle risorseDWORDcbData / / lunghezza dei dati delle risorse, in byte);
 

Parametri

hUpdate

Specifica un handle di file di aggiornamento. Questo handle viene restituito dalla funzione BeginUpdateResource.

lpType

Puntatore a una stringa con terminazione null che specifica il tipo di risorsa per essere aggiornato. Questo parametro può anche essere un valore integer passato alla macro MAKEINTRESOURCE , oppure può essere uno dei seguenti tipi di risorse predefinite:

Valore	Significato
RT_ACCELERATOR	Tabella Accelerator
RT_ANICURSOR	Cursore animato
RT_ANIICON	Icona animata
RT_BITMAP	Risorsa bitmap
RT_CURSOR	Risorse dipendenti dall'hardware cursor
RT_DIALOG	Nella finestra di dialogo
RT_FONT	Risorsa di tipo di carattere
RT_FONTDIR	Risorse di carattere directory
RT_GROUP_CURSOR	Risorsa indipendente dall'hardware cursor
RT_GROUP_ICON	Risorsa indipendente dall'hardware icona
RT_HTML	Documento HTML
RT_ICON	Risorsa icona dipendenti dall'hardware
RT_MENU	Risorsa di menu
RT_MESSAGETABLE	Voce della tabella messaggio
RT_RCDATA	Dall'applicazione risorse (dati grezzi)
RT_STRING	Voce della tabella stringa
RT_VERSION	Risorsa versione

lpName

Puntatore a una stringa null-terminated specificando il nome della risorsa di essere aggiornato. Questo parametro può anche essere un valore integer passato alla macro MAKEINTRESOURCE.

wLanguage

Specifica l'identificatore di lingua della risorsa per essere aggiornato. Per un elenco degli identificatori di lingua primaria e identificatori di lingua secondaria che compongono un identificatore di lingua, vedere la MAKELANGID macro.

lpData

Puntatore ai dati delle risorse da inserire nel file eseguibile. Se la risorsa è uno dei tipi predefiniti, i dati devono essere validi e correttamente allineato. Notare che questa è il dati binari non elaborati memorizzati nel file eseguibile, non i dati forniti da LoadIcon, LoadStringo altre funzioni specifiche della risorsa carico. Tutti i dati che contengono testo o stringhe devono essere in formato Unicode; lpData non deve puntare a dati ANSI.

Se lpData è NULL, la risorsa specificata viene eliminata dal file eseguibile.

cbData

Specifica la dimensione, in byte, dei dati delle risorse a lpData.

Valori restituiti

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per ottenere informazioni di errore estese, chiamare GetLastError.

Osservazioni

Un'applicazione può utilizzare più volte UpdateResource di apportare modifiche ai dati delle risorse. Ogni chiamata a UpdateResource contribuisce a un elenco interno di aggiunte, le eliminazioni e sostituzioni, ma in realtà non scrivere i dati del file eseguibile. L'applicazione deve utilizzare la funzione EndUpdateResource per scrivere le modifiche accumulate al file eseguibile.

Descrizione

nbsp; Windows &NT: richiede 3.1 o versione successiva.
Windows:Non supportato.
Windows CE:Non supportato.
Intestazione:Dichiarati in Winbase.
Importare librerie:Utilizzare il kernel.
Unicode:Implementato come versioni Unicode e ANSI su Windows NT.

Vedi anche

Panoramica di risorse, le funzioni delle risorse, BeginUpdateResource, EndUpdateResource, LoadIcon, LoadString, LockResource, MAKEINTRESOURCE, MAKELANGID, SizeofResource

Rimedio: Inserire il CD-ROM CD di MSDN Library.

Index