Funzione UpdateResourceA (winbase.h)

Aggiunge, elimina o sostituisce una risorsa in un file eseguibile portabile (PE). Esistono alcune restrizioni per gli aggiornamenti delle risorse nei file che contengono dati di Configurazione risorse (RC Config): file di (LN) e file di risorse specifiche della lingua (mui).

Sintassi

BOOL UpdateResourceA(
  [in]           HANDLE hUpdate,
  [in]           LPCSTR lpType,
  [in]           LPCSTR lpName,
  [in]           WORD   wLanguage,
  [in, optional] LPVOID lpData,
  [in]           DWORD  cb
);

Parametri

[in] hUpdate

Tipo: HANDLE

Handle di modulo restituito dalla funzione BeginUpdateResource, che fa riferimento al file da aggiornare.

[in] lpType

Tipo: LPCTSTR

Tipo di risorsa da aggiornare. In alternativa, anziché un puntatore, questo parametro può essere MAKEINTRESOURCE(ID), dove ID è un valore integer che rappresenta un tipo di risorsa predefinito. Se il primo carattere della stringa è un segno di cancelletto (#), i caratteri rimanenti rappresentano un numero decimale che specifica l'identificatore integer del tipo di risorsa. Ad esempio, la stringa "#258" rappresenta l'identificatore 258.

Per un elenco dei tipi di risorse predefiniti, vedere Tipi di risorse.

[in] lpName

Tipo: LPCTSTR

Nome della risorsa da aggiornare. In alternativa, anziché un puntatore, questo parametro può essere MAKEINTRESOURCE(ID), dove ID è un ID risorsa. Quando si crea una nuova risorsa non si usa una stringa che inizia con un carattere '#' per questo parametro.

[in] wLanguage

Tipo: WORD

Identificatore di lingua della risorsa da aggiornare. Per un elenco degli identificatori di lingua primari e degli identificatori di sottolanguage che costituiscono un identificatore di lingua, vedere la macro MAKELANGID.

[in, optional] lpData

Tipo: LPVOID

Dati delle risorse da inserire nel file indicato da hUpdate. Se la risorsa è uno dei tipi predefiniti, i dati devono essere validi e correttamente allineati. Si noti che si tratta dei dati binari non elaborati da archiviare nel file indicato da hUpdate, non i dati forniti da LoadIcon, LoadStringo altre funzioni di caricamento specifiche delle risorse. Tutti i dati contenenti stringhe o testo devono essere in formato Unicode. lpData non deve puntare ai dati ANSI.

Se lpData è NULL e cbData è 0, la risorsa specificata viene eliminata dal file indicato da hUpdate.

[in] cb

Tipo: DWORD

Dimensioni, in byte, dei dati delle risorse in lpData.

Valore restituito

Tipo: bool

Restituisce TRUE se ha esito positivo o false in caso contrario. Per ottenere informazioni estese sull'errore, chiamare GetLastError.

Osservazioni

È consigliabile che il file di risorse non venga caricato prima che venga chiamata questa funzione. Tuttavia, se il file è già caricato, non verrà restituito un errore.

Un'applicazione può usare UpdateResource ripetutamente per apportare modifiche ai dati delle risorse. Ogni chiamata a UpdateResource contribuisce a un elenco interno di aggiunte, eliminazioni e sostituzioni, ma non scrive effettivamente i dati nel file indicato da hUpdate. L'applicazione deve usare la funzione endUpdateResource per scrivere le modifiche accumulate nel file.

Questa funzione può aggiornare le risorse all'interno di moduli che contengono sia codice che risorse.

Precedenti a Windows 7: Se lpData è null e cbData è diverso da zero, la risorsa specificata NON viene eliminata e viene generata un'eccezione.

A partire da Windows Vista: Come indicato in precedenza, esistono restrizioni per gli aggiornamenti delle risorse nei file che contengono dati di configurazione RC: file LN e file mui. Le restrizioni sono le seguenti:

Esempi

Per un esempio, vedere aggiornamento delle risorse.

Fabbisogno

Vedere anche

BeginUpdateResource

concettuale

EndUpdateResource

loadIcon

LoadString

lockResource

MAKEINTRESOURCE

MAKELANGID

altre risorse

riferimento

risorse

SizeofResource