Funzione SymEnumSourceLinesW (dbghelp.h)
Enumera tutte le righe di origine in un modulo.
Sintassi
BOOL IMAGEAPI SymEnumSourceLinesW(
[in] HANDLE hProcess,
[in] ULONG64 Base,
[in, optional] PCWSTR Obj,
[in, optional] PCWSTR File,
[in, optional] DWORD Line,
[in] DWORD Flags,
[in] PSYM_ENUMLINES_CALLBACKW EnumLinesCallback,
[in, optional] PVOID UserContext
);
Parametri
[in] hProcess
Handle per 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
Una SymEnumLinesProc funzione di callback 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 non riesce, il valore restituito viene FALSE. Per recuperare informazioni sull'errore estese, chiamare GetLastError.
Osservazioni
Tutte le funzioni DbgHelp, ad esempio questa, sono a thread singolo. Pertanto, le chiamate da più thread a questa funzione genereranno probabilmente un comportamento imprevisto o un danneggiamento della memoria. Per evitare questo problema, è necessario sincronizzare tutte le chiamate simultanee da più thread a questa funzione.
Nota
L'intestazione dbghelp.h definisce SymEnumSourceLines come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.
Fabbisogno
| Requisito | Valore |
|---|---|
| piattaforma di destinazione | Finestre |
| intestazione |
dbghelp.h |
| libreria |
Dbghelp.lib |
| dll | Dbghelp.dll |
| Ridistribuibile | DbgHelp.dll 6.4 o versione successiva |