SymSrvDeltaNameW-Funktion (dbghelp.h)
Generiert den Namen einer Datei, die die Beziehung zwischen zwei verschiedenen Versionen desselben Symbols oder derselben Bilddatei beschreibt. Durch die Verwendung dieses Features wird verhindert, dass Anwendungen diese Informationen jedes Mal neu generieren müssen, wenn sie zwei Dateien analysieren.
Syntax
PCWSTR IMAGEAPI SymSrvDeltaNameW(
[in] HANDLE hProcess,
[in, optional] PCWSTR SymPath,
[in] PCWSTR Type,
[in] PCWSTR File1,
[in] PCWSTR File2
);
Parameter
[in] hProcess
Ein Handle für einen Prozess. Dieser Handle muss zuvor an die SymInitialize Funktion übergeben worden sein.
[in, optional] SymPath
Der Symbolpfad. Die Funktion verwendet nur die in der Standardsyntax beschriebenen Symbolspeicher für Symbolspeicher. 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 des Symbols oder der Bilddatei.
[in] File2
Der Pfad der zweiten Version des Symbols oder der Bilddatei.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert der resultierende Dateiname.
Wenn die Funktion fehlschlägt, ist der Rückgabewert NULL-. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen abzurufen.
Bemerkungen
Diese Funktion öffnet die beiden angegebenen Dateien, liest die Indizierungsinformationen aus der Kopfzeile 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 der File1gefolgt von einem Gedankenstrich, gefolgt vom Index File2gefolgt von einer .xml Erweiterung. Zum 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 daten, die sofort in einen anderen Puffer zurückgegeben wurden, zu kopieren.
Alle DbgHelp-Funktionen, z. B. diese, sind single threaded. Daher führen Aufrufe von mehr als einem Thread zu dieser Funktion wahrscheinlich zu unerwartetem Verhalten oder Speicherbeschädigung. Um dies zu vermeiden, müssen Sie alle gleichzeitigen Aufrufe von mehr als einem Thread mit dieser Funktion synchronisieren.
Um die Unicode-Version dieser Funktion aufzurufen, definieren Sie DBGHELP_TRANSLATE_TCHAR.
Anmerkung
Der dbghelp.h-Header definiert SymSrvDeltaName als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Zielplattform- | Fenster |
| Header- | dbghelp.h |
| Library | Dbghelp.lib |
| DLL- | Dbghelp.dll |
| redistributable | DbgHelp.dll 6.3 oder höher |