Función SymSetHomeDirectory (dbghelp.h)
Establece el directorio principal usado por Dbghelp.
Sintaxis
PCHAR IMAGEAPI SymSetHomeDirectory(
[in] HANDLE hProcess,
[in, optional] PCSTR dir
);
Parámetros
[in] hProcess
Identificador de un proceso. Este identificador debe haberse pasado previamente a la función SymInitialize .
[in, optional] dir
Directorio principal. Este directorio debe ser grabable; de lo contrario, el directorio principal es el directorio de aplicación común especificado con CSIDL_COMMON_APPDATA. Si este parámetro es NULL, la función usa el directorio predeterminado.
Valor devuelto
Si la función se ejecuta correctamente, el valor devuelto es un puntero al parámetro dir .
Si la función no se realiza correctamente, el valor devuelto es NULL. Para recuperar información de error extendida, llame a GetLastError.
Comentarios
El directorio principal predeterminado es el directorio en el que reside Dbghelp.dll. Dbghelp usa este directorio como base para otros directorios, como el directorio de almacén de bajada predeterminado (el subdirectorio simbólico del directorio principal).
El directorio principal utilizado para el almacén de símbolos predeterminado y la ubicación de caché del servidor de origen se almacena en la variable de entorno DBGHELP_HOMEDIR.
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
| Requisito | Value |
|---|---|
| Plataforma de destino | Windows |
| Encabezado | dbghelp.h |
| Library | Dbghelp.lib |
| Archivo DLL | Dbghelp.dll |
| Redistribuible | DbgHelp.dll 6.1 o posterior |