Freigeben über


SymSrvDeltaName-Funktion (dbghelp.h)

Generiert den Namen für eine Datei, die die Beziehung zwischen zwei verschiedenen Versionen desselben Symbols oder derselben Imagedatei beschreibt. Die Verwendung dieses Features verhindert, dass Anwendungen solche Informationen bei jeder Analyse von zwei Dateien erneut generieren müssen.

Syntax

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

Parameter

[in] hProcess

Ein Handle für einen Prozess. Dieses Handle muss zuvor an die SymInitialize-Funktion übergeben worden sein.

[in, optional] SymPath

Der Symbolpfad. Die Funktion verwendet nur die Symbolspeicher, die in der Standardsyntax für Symbolspeicher beschrieben werden. Alle anderen Pfade werden ignoriert. Wenn dieser Parameter NULL ist, verwendet die Funktion den Symbolpfad, der mithilfe der SymInitialize - oder SymSetSearchPath-Funktion festgelegt wurde.

[in] Type

Die Erweiterung für den generierten Dateinamen.

[in] File1

Der Pfad der ersten Version der Symbol- oder Imagedatei.

[in] File2

Der Pfad der zweiten Version des Symbols oder der Imagedatei.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert der resultierende Dateiname.

Wenn bei der Funktion ein Fehler auftritt, ist der Rückgabewert NULL. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen abzurufen.

Hinweise

Diese Funktion öffnet die beiden angegebenen Dateien, liest die Indizierungsinformationen aus dem Header und übergibt diese Informationen an den Symbolserver, damit er den Dateinamen erstellen kann. Wenn Sie den Type-Parameter als "xml" angeben, ist der Name der Index von File1, gefolgt von einem Bindestrich, gefolgt vom Index von File2, gefolgt von einer .xml-Erweiterung. Beispiel:

3F3D5C755000-3F3D647621000.xml

Diese Funktion gibt einen Zeiger auf einen Puffer zurück, der von einer anderen Funktion wiederverwendet werden kann. Achten Sie daher darauf, die zurückgegebenen Daten sofort in einen anderen Puffer zu kopieren.

Alle DbgHelp-Funktionen, z. B. diese, sind singlethreaded. Daher führen an diese Funktion gerichtete Aufrufe mehrerer Threads wahrscheinlich zu unerwartetem Verhalten oder einer Beschädigung des Speichers. Um dies zu vermeiden, müssen Sie alle an diese Funktion gerichteten gleichzeitigen Aufrufe mehrerer Threads synchronisieren.

Um die Unicode-Version dieser Funktion aufzurufen, definieren Sie DBGHELP_TRANSLATE_TCHAR.

Anforderungen

   
Zielplattform Windows
Kopfzeile dbghelp.h
Bibliothek Dbghelp.lib
DLL Dbghelp.dll
Verteilbare Komponente DbgHelp.dll 6.3 oder höher

Weitere Informationen

DbgHelp-Funktionen