SymSrvStoreFileW-Funktion (dbghelp.h)

Artikel
11/20/2024

Speichert eine Datei im angegebenen Symbolspeicher.

Syntax

PCWSTR IMAGEAPI SymSrvStoreFileW(
  [in]           HANDLE hProcess,
  [in, optional] PCWSTR SrvPath,
  [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] SrvPath

Der Symbolspeicher.

[in] File

Der Name der Datei.

[in] Flags

Die Kennzeichen, die die Funktion steuern. Dieser Parameter kann einer der folgenden Werte sein:

Wert	Bedeutung
SYMSTOREOPT_COMPRESS 0x01	Komprimieren Sie die Datei.
SYMSTOREOPT_OVERWRITE 0x02	Überschreiben Sie die Datei, wenn 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 mit Null beendete Zeichenfolge, die den vollqualifizierten Pfad zur gespeicherten Datei angibt.

Wenn die Funktion fehlschlägt, ist der Rückgabewert NULL-. Rufen Sie GetLastErrorauf, um erweiterte Fehlerinformationen abzurufen.

Bemerkungen

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.

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.

Um die Unicode-Version dieser Funktion aufzurufen, definieren Sie DBGHELP_TRANSLATE_TCHAR.

Anmerkung

Der dbghelp.h-Header definiert SymSrvStoreFile als Alias, der automatisch die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante 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

Siehe auch

DbgHelp-Funktionen

Freigeben über