Funzione BeginUpdateResourceA (winbase.h)

Articolo
03/08/2023

Recupera un handle che può essere usato 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; impossibile eseguire il file a cui fa riferimento pFileName . 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 tramite UpdateResource.

Valore restituito

Tipo: HANDLE

Se la funzione ha esito positivo, il valore restituito è un handle che può essere usato dalle funzioni UpdateResource e EndUpdateResource . Il valore restituito è NULL se il file specificato non è un PE, il file non esiste o il file non può essere aperto per la scrittura. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

È consigliabile che il file di risorse non venga caricato prima che questa funzione venga chiamata. 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 file con estensione mui associati. I dettagli sui tipi di risorse da aggiornare in questi file si trovano nella sezione Osservazioni per la funzione UpdateResource .

Questa funzione può aggiornare le risorse all'interno di moduli contenenti 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 di configurazione RC; i dettagli delle restrizioni si trovano nel riferimento per la funzione UpdateResource .

Esempio

Per un esempio, vedere Aggiornamento delle risorse.

Nota

L'intestazione winbase.h definisce BeginUpdateResource come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante preprocessore UNICODE. La combinazione dell'utilizzo dell'alias di codifica neutrale con il codice che non è neutrale dalla codifica può causare errori di corrispondenza che causano errori di compilazione o runtime. Per altre informazioni, vedere Convenzioni per i prototipi di funzione.

Requisiti


Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winbase.h (include Windows.h)
Libreria	Kernel32.lib
DLL	Kernel32.dll