Función SymSetSearchPathW (dbghelp.h)

Establece la ruta de acceso de búsqueda para el proceso especificado.

Sintaxis

BOOL IMAGEAPI SymSetSearchPathW(
  [in]           HANDLE hProcess,
  [in, optional] PCWSTR SearchPath
);

Parámetros

[in] hProcess

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

[in, optional] SearchPath

Ruta de acceso de búsqueda de símbolos. La cadena puede contener varias rutas de acceso separadas por punto y coma.

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

La ruta de acceso de búsqueda de símbolos se puede cambiar cualquier número de veces mientras una aplicación usa la biblioteca. El cambio afecta a todas las llamadas futuras al controlador de símbolos.

Para obtener la ruta de acceso de búsqueda actual, llame a la función SymGetSearchPath.

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.

Requisitos

Consulte también

funciones dbgHelp de

SymGetSearchPath

SymInitialize