Compartir a través de

Función SymGetSourceFileW (dbghelp.h)

  • Artículo

Recupera el archivo de origen especificado del servidor de origen.

Sintaxis

BOOL IMAGEAPI SymGetSourceFileW(
  [in]           HANDLE  hProcess,
  [in]           ULONG64 Base,
  [in, optional] PCWSTR  Params,
  [in]           PCWSTR  FileSpec,
  [out]          PWSTR   FilePath,
  [in]           DWORD   Size
);

Parámetros

[in] hProcess

Identificador de un proceso. Este identificador debe haberse pasado previamente a la función SymInitialize.

[in] Base

Dirección base del módulo.

[in, optional] Params

Este parámetro no se usa.

[in] FileSpec

Nombre del archivo de origen.

[out] FilePath

Puntero a un búfer que recibe la ruta de acceso completa del archivo de origen.

[in] Size

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

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

Para controlar qué directorio recibe los archivos de origen, use la función SymSetHomeDirectory.

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.

Nota

El encabezado dbghelp.h define SymGetSourceFile como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito Valor
de la plataforma de destino de Windows
encabezado de dbghelp.h
biblioteca de Dbghelp.lib
DLL de Dbghelp.dll
redistribuible DbgHelp.dll 6.2 o posterior

Consulte también

funciones dbgHelp de

servidor de origen