Funzione SymEnumSourceFiles (dbghelp.h)

Enumera tutti i file di origine in un processo.

Sintassi

BOOL IMAGEAPI SymEnumSourceFiles(
  [in]           HANDLE                        hProcess,
  [in]           ULONG64                       ModBase,
  [in, optional] PCSTR                         Mask,
  [in]           PSYM_ENUMSOURCEFILES_CALLBACK cbSrcFiles,
  [in, optional] PVOID                         UserContext
);

Parametri

[in] hProcess

Handle di un processo. Questo handle deve essere stato passato in precedenza alla funzione SymInitialize .

[in] ModBase

Indirizzo di base del modulo. Se questo valore è zero e Mask contiene un punto esclamativo (!), la funzione cerca tra i moduli. Se questo valore è zero e Mask non contiene un punto esclamativo, la funzione usa l'ambito stabilito dalla funzione SymSetContext .

[in, optional] Mask

Espressione con caratteri jolly che indica i nomi dei file di origine da enumerare. Per specificare un nome di modulo, usare ! sintassi mod .

Se questo parametro è NULL, la funzione enumererà tutti i file.

[in] cbSrcFiles

Puntatore a una funzione di callback SymEnumSourceFilesProc che riceve le informazioni sul file di origine.

[in, optional] UserContext

Valore definito dall'utente passato alla funzione di callback o NULL. Questo parametro viene in genere usato da un'applicazione per passare un puntatore a una struttura di dati che fornisce il contesto per la funzione di callback.

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

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

Vedi anche

Funzioni DbgHelp

SymEnumSourceFilesProc