Freigeben über


SymSrvStoreFile-Funktion (dbghelp.h)

Speichert eine Datei im angegebenen Symbolspeicher.

Syntax

PCSTR IMAGEAPI SymSrvStoreFile(
  [in]           HANDLE hProcess,
  [in, optional] PCSTR  SrvPath,
  [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 Symbolspeicher.

[in] File

Der Name der Datei.

[in] Flags

Die Flags, die die Funktion steuern. Dieser Parameter kann einen der folgenden Werte annehmen.

Wert Bedeutung
SYMSTOREOPT_COMPRESS
0x01
Komprimieren Sie die Datei.
SYMSTOREOPT_OVERWRITE
0x02
Überschreiben Sie die Datei, sofern sie vorhanden ist.
SYMSTOREOPT_PASS_IF_EXISTS
0x40
Melden Sie keinen Fehler, wenn die Datei bereits im Symbolspeicher vorhanden ist.
SYMSTOREOPT_POINTER
0x08
Speichern Sie in File.ptr.
SYMSTOREOPT_RETURNINDEX
0x04
Gibt nur den Index zurück.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ein Zeiger auf eine NULL-Zeichenfolge, die den vollqualifizierten Pfad zur gespeicherten Datei angibt.

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

Hinweise

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.

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.

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 Version 6.3 oder höher

Weitere Informationen

DbgHelp-Funktionen