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