Función SymSearch (dbghelp.h)

Busca símbolos PDB que cumplan los criterios especificados.

Sintaxis

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
);

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. Si este valor es cero y Mask contiene un signo de exclamación (!), la función busca en los módulos. Si este valor es cero y Mask no contiene un signo de exclamación, la función usa el ámbito establecido por la función SymSetContext .

[in, optional] Index

Valor único para el símbolo.

[in, optional] SymTag

Clasificación de PDB. Estos valores se definen en Dbghelp.h en el tipo de enumeración SymTagEnum . Para obtener descripciones, consulte la documentación de PDB.

[in, optional] Mask

Expresión comodín que indica los nombres de los símbolos que se van a enumerar. Para especificar un nombre de módulo, use ! sintaxis mod .

[in, optional] Address

Dirección del símbolo.

[in] EnumSymbolsCallback

Función de devolución de llamada SymEnumSymbolsProc que recibe la información del símbolo.

[in, optional] UserContext

Valor definido por el usuario que se pasa a la función de devolución de llamada o NULL. Normalmente, una aplicación usa este parámetro para pasar un puntero a una estructura de datos que proporciona contexto para la función de devolución de llamada.

[in] Options

Las opciones que controlan el comportamiento de esta función.

Valor	Significado
SYMSEARCH_ALLITEMS 0x08	Incluya todos los símbolos y otros datos en los archivos .pdb. DbgHelp 6.6 y versiones anteriores: Este valor no se admite.
SYMSEARCH_GLOBALSONLY 0x04	Busque solo símbolos globales.
SYMSEARCH_MASKOBJS 0x01	Solo para uso interno.
SYMSEARCH_RECURSE 0x02	Recursión de la parte superior para buscar todos los símbolos.

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.

Para llamar a la versión Unicode de esta función, defina DBGHELP_TRANSLATE_TCHAR.

Requisitos

Plataforma de destino	Windows
Encabezado	dbghelp.h
Library	Dbghelp.lib
Archivo DLL	Dbghelp.dll
Redistribuible	DbgHelp.dll 6.2 o posterior

Consulte también

Funciones de DbgHelp

SymEnumSymbolsProc