Funzione BeginUpdateResourceA (winbase.h)
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 |
Vedere anche
Informazioni concettuali
Riferimento