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 |