Funzione SymEnumSourceLines (dbghelp.h)
Enumera tutte le righe di origine in un modulo.
Sintassi
BOOL IMAGEAPI SymEnumSourceLines(
[in] HANDLE hProcess,
[in] ULONG64 Base,
[in, optional] PCSTR Obj,
[in, optional] PCSTR File,
[in, optional] DWORD Line,
[in] DWORD Flags,
[in] PSYM_ENUMLINES_CALLBACK EnumLinesCallback,
[in, optional] PVOID UserContext
);
Parametri
[in] hProcess
Handle di un processo. Questo handle deve essere stato passato in precedenza alla funzione SymInitialize .
[in] Base
Indirizzo di base del modulo.
[in, optional] Obj
Nome di un file .obj all'interno del modulo. L'ambito dell'enumerazione è limitato a questo file. Se questo parametro è NULL o una stringa vuota, vengono cercati tutti i file .obj.
[in, optional] File
Espressione con caratteri jolly che indica i nomi dei file di origine da cercare. Se questo parametro è NULL o una stringa vuota, vengono cercati tutti i file.
[in, optional] Line
Numero di riga di una riga all'interno del modulo. L'ambito dell'enumerazione è limitato a questa riga. Se questo parametro è 0, vengono eseguite ricerche in tutte le righe.
[in] Flags
Se questo parametro è ESLFLAG_FULLPATH, la funzione corrisponde al percorso completo nel parametro File .
[in] EnumLinesCallback
Funzione di callback SymEnumLinesProc che riceve le informazioni sulla riga.
[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
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Windows |
| Intestazione | dbghelp.h |
| Libreria | Dbghelp.lib |
| DLL | Dbghelp.dll |
| Componente ridistribuibile | DbgHelp.dll 6.4 o versioni successive |