Funzione SymEnumTypesByName (dbghelp.h)

Enumera tutti i tipi definiti dall'utente.

Sintassi

BOOL IMAGEAPI SymEnumTypesByName(
  [in]           HANDLE                         hProcess,
  [in]           ULONG64                        BaseOfDll,
  [in, optional] PCSTR                          mask,
  [in]           PSYM_ENUMERATESYMBOLS_CALLBACK EnumSymbolsCallback,
  [in]           PVOID                          UserContext
);

Parametri

[in] hProcess

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

[in] BaseOfDll

Indirizzo di base del modulo.

[in, optional] mask

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

[in] EnumSymbolsCallback

Puntatore a una funzione di callback SymEnumSymbolsProc che riceve le informazioni sul simbolo.

[in] UserContext

Valore definito dall'utente da passare 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 informazioni di 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. Pertanto, le chiamate da più thread a questa funzione potrebbero causare 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

Vedi anche

Funzioni DbgHelp

SymEnumSymbolsProc