Funzione SymSearch (dbghelp.h)

Articolo
08/23/2023

Cerca i simboli PDB che soddisfano i criteri specificati.

Sintassi

BOOL IMAGEAPI SymSearch(
  [in]           HANDLE                         hProcess,
  [in]           ULONG64                        BaseOfDll,
  [in, optional] DWORD                          Index,
  [in, optional] DWORD                          SymTag,
  [in, optional] PCSTR                          Mask,
  [in, optional] DWORD64                        Address,
  [in]           PSYM_ENUMERATESYMBOLS_CALLBACK EnumSymbolsCallback,
  [in, optional] PVOID                          UserContext,
  [in]           DWORD                          Options
);

Parametri

[in] hProcess

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

[in] BaseOfDll

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] Index

Valore univoco per il simbolo.

[in, optional] SymTag

Classificazione PDB. Questi valori sono definiti in Dbghelp.h nel tipo di enumerazione SymTagEnum . Per le descrizioni, vedere la documentazione di PDB.

[in, optional] Mask

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

[in, optional] Address

Indirizzo del simbolo.

[in] EnumSymbolsCallback

Funzione di callback SymEnumSymbolsProc che riceve le informazioni sul simbolo.

[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.

[in] Options

Opzioni che controllano il comportamento di questa funzione.

Valore	Significato
SYMSEARCH_ALLITEMS 0x08	Includere tutti i simboli e altri dati nei file con estensione pdb. DbgHelp 6.6 e versioni precedenti: Questo valore non è supportato.
SYMSEARCH_GLOBALSONLY 0x04	Cercare solo i simboli globali.
SYMSEARCH_MASKOBJS 0x01	Solo per uso interno.
SYMSEARCH_RECURSE 0x02	Recurse dalla parte superiore per trovare tutti i simboli.

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.

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.2 o versione successiva

Vedi anche

Funzioni DbgHelp

SymEnumSymbolsProc

Condividi tramite