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

Vedi anche

Funzioni ImageHlp

LOADED_IMAGE

UnMapAndLoad