Funzione SymGetScope (dbghelp.h)

Recupera l'ambito per l'indice specificato.

Sintassi

BOOL IMAGEAPI SymGetScope(
  [in]      HANDLE       hProcess,
  [in]      ULONG64      BaseOfDll,
  [in]      DWORD        Index,
  [in, out] PSYMBOL_INFO Symbol
);

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.

[in] Index

Valore univoco per il simbolo.

[in, out] Symbol

Puntatore a una struttura SYMBOL_INFO . Il membro Scope contiene l'ambito.

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

Vedi anche

Funzioni DbgHelp

SYMBOL_INFO

SymSetScopeFromAddr

SymSetScopeFromIndex