Funzione SymEnumLines (dbghelp.h)

  • Articolo

Enumera tutte le righe nel modulo specificato.

Sintassi

BOOL IMAGEAPI SymEnumLines(
  [in]           HANDLE                  hProcess,
  [in]           ULONG64                 Base,
  [in, optional] PCSTR                   Obj,
  [in, optional] PCSTR                   File,
  [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 con estensione 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] 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

Questa funzione è supportata solo per le informazioni PDB. Se si dispone di informazioni SUFF, provare a usare una delle funzioni SymGetLineXXX .

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.

Per chiamare la versione Unicode di questa funzione, definire DBGHELP_TRANSLATE_TCHAR.

Requisiti

   
Piattaforma di destinazione Windows
Intestazione dbghelp.h
Libreria Dbghelp.lib
DLL Dbghelp.dll
Componente ridistribuibile DbgHelp.dll 6.1 o versione successiva

Vedi anche

Funzioni DbgHelp

SymEnumLinesProc