Función SymGetScope (dbghelp.h)

Artículo
02/26/2024

Recupera el ámbito del índice especificado.

Sintaxis

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

Parámetros

[in] hProcess

Identificador de un proceso. Este identificador debe haberse pasado previamente a la función SymInitialize .

[in] BaseOfDll

Dirección base del módulo.

[in] Index

Valor único para el símbolo.

[in, out] Symbol

Puntero a una estructura de SYMBOL_INFO . El miembro Scope contiene el ámbito.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es TRUE.

Si se produce un error en la función, el valor devuelto es FALSE. Para recuperar información de error extendida, llame a GetLastError.

Comentarios

Todas las funciones DbgHelp, como esta, son un único subproceso. Por lo tanto, es probable que las llamadas desde más de un subproceso a esta función producirán un comportamiento inesperado o daños en la memoria. Para evitarlo, debe sincronizar todas las llamadas simultáneas de más de un subproceso a esta función.