SymSrvStoreSupplement-Funktion (dbghelp.h)

Speichert eine Datei in der angegebenen Ergänzung zu einem Symbolspeicher. Die Datei ist in der Regel einer Datei auf dem Symbolserver zugeordnet.

Syntax

PCSTR IMAGEAPI SymSrvStoreSupplement(
  [in]           HANDLE hProcess,
  [in, optional] PCSTR  SrvPath,
  [in]           PCSTR  Node,
  [in]           PCSTR  File,
  [in]           DWORD  Flags
);

Parameter

[in] hProcess

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

[in, optional] SrvPath

Der Pfad zum Symbolspeicher.

[in] Node

Die Symboldatei, die der zusätzlichen Datei zugeordnet ist.

[in] File

Der Name der Datei.

[in] Flags

Wenn dieser Parameter SYMSTOREOPT_COMPRESS ist, wird die Datei im Symbolspeicher komprimiert. Derzeit werden keine anderen Werte unterstützt.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert der vollqualifizierte Pfad für die zusätzliche Datei.

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

Hinweise

Eine wichtige Verwendung für diese Funktion ist das Speichern von Deltadateien. Weitere Informationen finden Sie unter SymSrvDeltaName.

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

Der Symbolserver speichert zusätzliche Dateien mit der gleichen Erweiterung in einem gemeinsamen Verzeichnis. Beispielsweise werden Sup1.xml im folgenden Verzeichnis gespeichert: SymPath\supplement\Node\xml.

Der Administrator eines Speichers kann Verhindern, dass Benutzer zusätzliche Dateien schreiben, indem er eine schreibgeschützte Datei im Stammverzeichnis des Speichers namens Supplement erstellt. Alternativ kann der Administrator das Ergänzungsverzeichnis erstellen und ACLs zum Steuern des Zugriffs verwenden.

Alle DbgHelp-Funktionen, z. B. diese, sind single threaded. 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

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

Weitere Informationen

DbgHelp-Funktionen

SymSrvGetSupplement