Funzione ImageLoad (imagehlp.h)

Gestisce un elenco di DLL caricate.

Sintassi

PLOADED_IMAGE IMAGEAPI ImageLoad(
  [in] PCSTR DllName,
  [in] PCSTR DllPath
);

Parametri

[in] DllName

Nome dell'immagine.

[in] DllPath

Percorso usato per individuare l'immagine se non è possibile trovare il nome specificato. Se viene usato NULL , le regole del percorso di ricerca impostate nella funzione SearchPath si applicano.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è un puntatore a una struttura LOADED_IMAGE .

Se la funzione ha esito negativo, il valore restituito è NULL. Per recuperare informazioni sull'errore estese, chiamare GetLastError.

Commenti

La funzione ImageLoad viene usata per mantenere un elenco di DLL caricate. Se l'immagine è già stata caricata, viene restituita la LOADED_IMAGE precedente. In caso contrario, la nuova immagine viene aggiunta all'elenco.

La struttura LOADED_IMAGE deve essere deallocata dalla funzione ImageUnload .

Tutte le funzioni ImageHlp, ad esempio questa, sono a thread singolo. Pertanto, le chiamate da più thread a questa funzione potrebbero causare 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

ImageUnload

LOADED_IMAGE