Funzione MapDebugInformation (dbghelp.h)

Articolo
02/27/2024

Ottiene l'accesso alle informazioni di debug per un'immagine.

Nota Questa funzione viene fornita solo per la compatibilità con le versioni precedenti. Non restituisce informazioni affidabili. Le nuove applicazioni devono usare le funzioni SymGetModuleInfo64 e SymLoadModule64 .

Sintassi

PIMAGE_DEBUG_INFORMATION IMAGEAPI MapDebugInformation(
  [in, optional] HANDLE FileHandle,
  [in]           PCSTR  FileName,
  [in, optional] PCSTR  SymbolPath,
  [in]           ULONG  ImageBase
);

Parametri

[in, optional] FileHandle

Handle per un'immagine eseguibile aperta o NULL.

[in] FileName

Nome di un file di immagine eseguibile o NULL.

[in, optional] SymbolPath

Percorso in cui si trovano i file di simboli. Il percorso può essere composto da più percorsi separati da punti e virgola. Per recuperare il percorso del simbolo, usare la funzione SymGetSearchPath .

[in] ImageBase

Indirizzo di base per l'immagine o zero.

Valore restituito

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

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

Commenti

La funzione MapDebugInformation viene usata per ottenere l'accesso alle informazioni di debug di un'immagine. Le informazioni di debug vengono estratte dall'immagine o dal file di simboli e inserite nella struttura IMAGE_DEBUG_INFORMATION . Questa struttura viene allocata dalla libreria e deve essere deallocata usando la funzione UnmapDebugInformation . La memoria per la struttura non è nell'heap predefinita del processo, quindi i tentativi di liberarlo con una routine di deallocazione della memoria avranno esito negativo.

Tutte le funzioni DbgHelp, 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

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	dbghelp.h
Libreria	Dbghelp.lib
DLL	Dbghelp.dll
Componente ridistribuibile	DbgHelp.dll 5.1 o versioni successive

Vedi anche

Funzioni DbgHelp

IMAGE_DEBUG_INFORMATION

SymGetSearchPath

UnmapDebugInformation

Condividi tramite