Compartir a través de

Función SymGetHomeDirectory (dbghelp.h)

  • Artículo

Recupera el directorio principal usado por Dbghelp.

Sintaxis

PCHAR IMAGEAPI SymGetHomeDirectory(
  [in]  DWORD  type,
  [out] PSTR   dir,
  [in]  size_t size
);

Parámetros

[in] type

Directorio que se va a recuperar. Este parámetro puede ser uno de los valores siguientes.

Valor Significado
hdBase
0
 Directorio principal.
hdSrc
2
 Directorio de origen.
hdSym
1
 Directorio de símbolos.

[out] dir

Puntero a una cadena que recibe el directorio.

[in] size

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

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

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

Consulte también

Funciones de DbgHelp

SymSetHomeDirectory