SymSrvStoreSupplementW-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
PCWSTR IMAGEAPI SymSrvStoreSupplementW(
[in] HANDLE hProcess,
[in, optional] PCWSTR SymPath,
[in] PCWSTR Node,
[in] PCWSTR File,
[in] DWORD Flags
);
Parameter
[in] hProcess
Ein Handle für einen Prozess. Dieser Handle muss zuvor an die SymInitialize Funktion übergeben worden sein.
[in, optional] SymPath
Der Pfad zum Symbolspeicher.
[in] Node
Die Symboldatei, die der ergänzenden Datei zugeordnet ist.
[in] File
Der Name der Datei.
[in] Flags
Wenn dieser Parameter SYMSTOREOPT_COMPRESSist, wird die Datei im Symbolspeicher komprimiert. Derzeit gibt es keine anderen unterstützten Werte.
Rückgabewert
Wenn die Funktion erfolgreich ist, ist der Rückgabewert der vollqualifizierte Pfad für die ergänzende Datei.
Wenn die Funktion fehlschlägt, ist der Rückgabewert NULL-. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen abzurufen.
Bemerkungen
Eine wichtige Verwendung für diese Funktion ist das Speichern von Delta-Dateien. Weitere Informationen finden Sie unter SymSrvDeltaName.
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.
Auf dem Symbolserver werden ergänzende Dateien mit derselben Erweiterung in einem gemeinsamen Verzeichnis gespeichert. Beispielsweise würde Sup1.xml im folgenden Verzeichnis gespeichert: SymPath\supplement\Node\xml.
Der Administrator eines Speichers kann verhindern, dass Benutzer ergänzende Dateien schreiben, indem eine schreibgeschützte Datei im Stammverzeichnis des Informationsspeichers namens "Ergänzung" erstellt wird. Alternativ kann der Administrator das Ergänzende Verzeichnis erstellen und ACLs verwenden, um den Zugriff zu steuern.
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 SymSrvStoreSupplement als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch 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 |