Función SymGetSearchPath (dbghelp.h)

Artículo
08/23/2023

Recupera la ruta de búsqueda de símbolos para el proceso especificado.

Sintaxis

BOOL IMAGEAPI SymGetSearchPath(
  [in]  HANDLE hProcess,
  [out] PSTR   SearchPath,
  [in]  DWORD  SearchPathLength
);

Parámetros

[in] hProcess

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

[out] SearchPath

Puntero al búfer que recibe la ruta de búsqueda de símbolos.

[in] SearchPathLength

Tamaño del búfer de SearchPath , en caracteres.

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

La función SymGetSearchPath copia la ruta de búsqueda de símbolos del proceso especificado en el búfer de SearchPath . Si se produce un error en la función, el contenido del búfer no está definido.

Para especificar una ruta de búsqueda de símbolos para el proceso, use la función SymSetSearchPath .

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.