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 |