Funzione MapAndLoad (imagehlp.h)
Esegue il mapping di un'immagine e precarica i dati dal file mappato.
Sintassi
BOOL IMAGEAPI MapAndLoad(
[in] PCSTR ImageName,
[in] PCSTR DllPath,
[out] PLOADED_IMAGE LoadedImage,
[in] BOOL DotDll,
[in] BOOL ReadOnly
);
Parametri
[in] ImageName
Nome file dell'immagine (file eseguibile o DLL) caricata.
[in] DllPath
Percorso usato per individuare l'immagine se non è possibile trovare il nome specificato. Se questo parametro è NULL, si applicano le regole del percorso di ricerca impostate usando la funzione SearchPath .
[out] LoadedImage
Puntatore a una struttura LOADED_IMAGE che riceve informazioni sull'immagine dopo il caricamento.
[in] DotDll
Estensione predefinita da utilizzare se il nome dell'immagine non contiene un'estensione di file. Se il valore è TRUE, viene usata un'estensione .DLL. Se il valore è FALSE, viene usata un'estensione .EXE.
[in] ReadOnly
Modalità di accesso. Se questo valore è TRUE, viene eseguito il mapping del file solo per l'accesso in lettura. Se il valore è FALSE, viene eseguito il mapping del file per l'accesso in lettura e scrittura.
Valore restituito
Se la funzione ha esito positivo, il valore restituito è TRUE.
Se la funzione ha esito negativo, il valore restituito è FALSE. Per recuperare informazioni sull'errore estese, chiamare GetLastError.
Commenti
La funzione MapAndLoad esegue il mapping di un'immagine e precarica i dati dal file mappato. La funzione corrispondente , UnMapAndLoad, deve essere usata per deallocare tutte le risorse allocate dalla funzione MapAndLoad .
Tutte le funzioni ImageHlp, ad esempio questa, sono a thread singolo. Di conseguenza, le chiamate da più thread a questa funzione genereranno un comportamento imprevisto o un danneggiamento della memoria. Per evitare questo problema, è necessario sincronizzare tutte le chiamate simultanee da più thread a questa funzione.
Requisiti
| Client minimo supportato | Windows XP [solo app desktop] |
| Server minimo supportato | Windows Server 2003 [solo app desktop] |
| Piattaforma di destinazione | Windows |
| Intestazione | imagehlp.h |
| Libreria | Imagehlp.lib |
| DLL | Imagehlp.dll |