Función SymGetSymbolFile (dbghelp.h)

Busca un archivo de símbolos en la ruta de acceso de símbolo especificada.

Sintaxis

BOOL IMAGEAPI SymGetSymbolFile(
  [in, optional] HANDLE hProcess,
  [in, optional] PCSTR  SymPath,
  [in]           PCSTR  ImageFile,
  [in]           DWORD  Type,
  [out]          PSTR   SymbolFile,
  [in]           size_t cSymbolFile,
  [out]          PSTR   DbgFile,
  [in]           size_t cDbgFile
);

Parámetros

[in, optional] hProcess

Identificador del proceso que se pasó originalmente a la función SymInitialize .

Si este identificador es 0, SymPath no puede ser NULL. Use esta opción para cargar un archivo de símbolos sin llamar a SymInitialize o SymCleanup.

[in, optional] SymPath

Ruta de acceso del símbolo. Si este parámetro es NULL o una cadena vacía, la función usa la ruta de acceso del símbolo establecida mediante la función SymInitialize o SymSetSearchPath .

[in] ImageFile

Nombre del archivo de imagen.

[in] Type

Tipo de archivo de símbolos. Este parámetro puede ser uno de los valores siguientes.

Valor	Significado
sfImage 0	Un archivo .exe o .dll.
sfDbg 1	Un archivo .dbg.
sfPdb 2	Un archivo .pdb.
sfMpd 3	Reservado.

[out] SymbolFile

Puntero a una cadena terminada en null que recibe el nombre del archivo de símbolos.

[in] cSymbolFile

Tamaño del búfer SymbolFile , en caracteres.

[out] DbgFile

Puntero a un búfer que recibe la ruta de acceso completa al archivo de símbolos. Este búfer debe tener al menos MAX_PATH caracteres.

[in] cDbgFile

Tamaño del búfer DbgFile , en caracteres.

Valor devuelto

Si el servidor busca un archivo de símbolos válido, devuelve TRUE; de lo contrario, devuelve FALSE y GetLastError devuelve un valor que indica por qué no se devolvió el archivo de símbolos.

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.3 o posterior

Consulte también

Funciones de DbgHelp

SymInitialize