Funzione BeginUpdateResourceA (winbase.h)

Recupera un handle che può essere utilizzato dalla funzione UpdateResource per aggiungere, eliminare o sostituire le risorse in un modulo binario.

Sintassi

HANDLE BeginUpdateResourceA(
  [in] LPCSTR pFileName,
  [in] BOOL   bDeleteExistingResources
);

Parametri

[in] pFileName

Tipo: LPCTSTR

File binario in cui aggiornare le risorse. Un'applicazione deve essere in grado di ottenere l'accesso in scrittura a questo file; Il file a cui fa riferimento pFileName non può essere attualmente in esecuzione. Se pFileName non specifica un percorso completo, il sistema cerca il file nella directory corrente.

[in] bDeleteExistingResources

Tipo: bool

Indica se eliminare le risorse esistenti del parametro pFileName. Se questo parametro è TRUE, le risorse esistenti vengono eliminate e il file aggiornato include solo le risorse aggiunte con la funzione UpdateResource. Se questo parametro è FALSE, il file aggiornato include risorse esistenti a meno che non vengano eliminate o sostituite in modo esplicito usando UpdateResource.

Valore restituito

Tipo: HANDLE

Se la funzione ha esito positivo, il valore restituito è un handle che può essere usato dalle funzioni di UpdateResource e EndUpdateResource. Il valore restituito è NULL se il file specificato non è pe, il file non esiste o non può essere aperto per la scrittura. 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.

Esistono alcune restrizioni per gli aggiornamenti delle risorse nei file che contengono dati di Resource Configuration(RC Config): file LN e i file mui associati. I dettagli sui tipi di risorse che possono essere aggiornati in questi file sono disponibili nella sezione Osservazioni per la funzione UpdateResource .

Questa funzione può aggiornare le risorse all'interno di moduli che contengono sia codice che risorse. Come indicato in precedenza, esistono restrizioni per gli aggiornamenti delle risorse nei file LN e nei file mui, entrambi contenenti dati rc config; i dettagli delle restrizioni sono disponibili nel riferimento per la funzione UpdateResource .

Esempi

Per un esempio, vedere Aggiornamento delle risorse.

Fabbisogno

Vedere anche

concettuale

EndUpdateResource

riferimento

risorse

UpdateResource