Função SymGetScope (dbghelp.h)

Artigo
02/26/2024

Recupera o escopo do índice especificado.

Sintaxe

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

Parâmetros

[in] hProcess

Um identificador para um processo. Esse identificador deve ter sido passado anteriormente para a função SymInitialize .

[in] BaseOfDll

O endereço base do módulo.

[in] Index

Um valor exclusivo para o símbolo.

[in, out] Symbol

Um ponteiro para uma estrutura SYMBOL_INFO . O membro Scope contém o escopo.

Retornar valor

Se a função for bem-sucedida, o valor retornado será TRUE.

Se a função falhar, o valor retornado será FALSE. Para recuperar informações de erro estendidas, chame GetLastError.

Comentários

Todas as funções DbgHelp, como esta, são threaded único. Portanto, chamadas de mais de um thread para essa função provavelmente resultarão em comportamento inesperado ou corrupção de memória. Para evitar isso, você deve sincronizar todas as chamadas simultâneas de mais de um thread para essa função.