Función SymSrvDeltaName (dbghelp.h)
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
PCSTR IMAGEAPI SymSrvDeltaName(
[in] HANDLE hProcess,
[in, optional] PCSTR SymPath,
[in] PCSTR Type,
[in] PCSTR File1,
[in] PCSTR 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 del 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 imagen o símbolo.
[in] File2
Ruta de acceso de la segunda versión del archivo de imagen o símbolo.
Valor devuelto
Si la función se realiza correctamente, el valor devuelto es el nombre de archivo resultante.
Si la función no se realiza correctamente, el valor devuelto es NULL. Para recuperar información de error extendida, llame a GetLastError.
Comentarios
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 de .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 ú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
| Plataforma de destino | Windows |
| Encabezado | dbghelp.h |
| Library | Dbghelp.lib |
| Archivo DLL | Dbghelp.dll |
| Redistribuible | DbgHelp.dll 6.3 o posterior |