Funzione SymSrvDeltaName (dbghelp.h)

Articolo
08/23/2023

Genera il nome di un file che descrive la relazione tra due versioni diverse dello stesso file di simboli o immagini. L'uso di questa funzionalità impedisce alle applicazioni di rigenerare tali informazioni ogni volta che analizzano due file.

Sintassi

PCSTR IMAGEAPI SymSrvDeltaName(
  [in]           HANDLE hProcess,
  [in, optional] PCSTR  SymPath,
  [in]           PCSTR  Type,
  [in]           PCSTR  File1,
  [in]           PCSTR  File2
);

Parametri

[in] hProcess

Handle di un processo. Questo handle deve essere stato passato in precedenza alla funzione SymInitialize .

[in, optional] SymPath

Percorso del simbolo. La funzione usa solo gli archivi di simboli descritti nella sintassi standard per gli archivi simboli. Tutti gli altri percorsi vengono ignorati. Se questo parametro è NULL, la funzione usa il percorso del simbolo impostato usando la funzione SymInitialize o SymSetSearchPath .

[in] Type

Estensione per il nome del file generato.

[in] File1

Percorso della prima versione del file di simboli o immagini.

[in] File2

Percorso della seconda versione del file di simboli o immagini.

Valore restituito

Se la funzione ha esito positivo, il valore restituito è il nome del file risultante.

Se la funzione ha esito negativo, il valore restituito è NULL. Per recuperare informazioni sull'errore estese, chiamare GetLastError.

Commenti

Questa funzione apre i due file specificati, legge le informazioni di indicizzazione dall'intestazione e passa queste informazioni al server dei simboli in modo che possa creare il nome del file. Se si specifica il parametro Type come "xml", il nome è l'indice di File1, seguito da un trattino, seguito dall'indice di File2, seguito da un'estensione .xml. Ad esempio:

3F3D5C755000-3F3D647621000.xml

Questa funzione restituisce un puntatore a un buffer che può essere riutilizzato da un'altra funzione. Assicurarsi quindi di copiare immediatamente i dati restituiti in un altro buffer.

Tutte le funzioni DbgHelp, ad esempio questa, sono a thread singolo. Di conseguenza, le chiamate da più thread a questa funzione genereranno un comportamento imprevisto o un danneggiamento della memoria. Per evitare questo problema, è necessario sincronizzare tutte le chiamate simultanee da più thread a questa funzione.

Per chiamare la versione Unicode di questa funzione, definire DBGHELP_TRANSLATE_TCHAR.

Requisiti


Piattaforma di destinazione	Windows
Intestazione	dbghelp.h
Libreria	Dbghelp.lib
DLL	Dbghelp.dll
Componente ridistribuibile	DbgHelp.dll 6.3 o versione successiva

Vedi anche

Funzioni DbgHelp

Condividi tramite