Función SymSrvDeltaNameW (dbghelp.h)

Artículo
11/20/2024

Genera el nombre de un archivo que describe la relación entre dos versiones diferentes del mismo archivo de imagen o símbolo. El uso de esta característica impide que las aplicaciones tengan que volver a generar dicha información cada vez que analizan dos archivos.

Sintaxis

PCWSTR IMAGEAPI SymSrvDeltaNameW(
  [in]           HANDLE hProcess,
  [in, optional] PCWSTR SymPath,
  [in]           PCWSTR Type,
  [in]           PCWSTR File1,
  [in]           PCWSTR File2
);

Parámetros

[in] hProcess

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

[in, optional] SymPath

Ruta de acceso del símbolo. La función usa solo los almacenes de símbolos descritos en sintaxis estándar para los almacenes de símbolos. Se omiten todas las demás rutas de acceso. Si este parámetro es null, la función usa la ruta de acceso de símbolo establecida mediante la función SymInitialize o SymSetSearchPath.

[in] Type

Extensión para el nombre de archivo generado.

[in] File1

Ruta de acceso de la primera versión del archivo de símbolo o imagen.

[in] File2

Ruta de acceso de la segunda versión del archivo de símbolo o imagen.

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es el nombre de archivo resultante.

Si se produce un error en la función, el valor devuelto es NULL. Para recuperar información de error extendida, llame a GetLastError.

Observaciones

Esta función abre los dos archivos especificados, lee la información de indexación del encabezado y pasa esta información al servidor de símbolos para que pueda crear el nombre de archivo. Si especifica el parámetro type como "xml", el nombre es el índice de File1, seguido de un guión, seguido del índice de File2, seguido de una extensión .xml. Por ejemplo:

3F3D5C755000-3F3D647621000.xml

Esta función devuelve un puntero a un búfer que otra función puede reutilizar. Por lo tanto, asegúrese de copiar los datos devueltos a otro búfer inmediatamente.

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 SymSrvDeltaName 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.3 o posterior

Consulte también

funciones dbgHelp de

Compartir a través de