Función SymSearchW (dbghelp.h)

Busca símbolos PDB que cumplan los criterios especificados.

Sintaxis

BOOL IMAGEAPI SymSearchW(
  [in]           HANDLE                          hProcess,
  [in]           ULONG64                         BaseOfDll,
  [in, optional] DWORD                           Index,
  [in, optional] DWORD                           SymTag,
  [in, optional] PCWSTR                          Mask,
  [in, optional] DWORD64                         Address,
  [in]           PSYM_ENUMERATESYMBOLS_CALLBACKW 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 SymTagEnum tipo de enumeración. 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

Un SymEnumSymbolsProc función de devolución de llamada 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

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	Recurse desde la parte superior para buscar todos los símbolos.

Valor devuelto

Si la función se ejecuta 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.

Observaciones

Todas las funciones DbgHelp, como esta, son un solo subproceso. Por lo tanto, las llamadas de más de un subproceso a esta función probablemente provocarán un comportamiento inesperado o daños en la memoria. Para evitar esto, 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.

Nota

El encabezado dbghelp.h define SymSearch como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
de la plataforma de destino de	Windows
encabezado de	dbghelp.h
biblioteca de	Dbghelp.lib
DLL de	Dbghelp.dll
redistribuible	DbgHelp.dll 6.2 o posterior

Consulte también

funciones dbgHelp de

SymEnumSymbolsProc