SymSrvStoreFile-Funktion (dbghelp.h)

Artikel
08/23/2023

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

Share via