SymAddSourceStream-Funktion (dbghelp.h)

Artikel
03/06/2024

Fügt den Stream dem angegebenen Modul zur Verwendung durch den Quellserver hinzu.

Syntax

BOOL IMAGEAPI SymAddSourceStream(
  [in]           HANDLE  hProcess,
  [in]           ULONG64 Base,
  [in, optional] PCSTR   StreamFile,
  [in, optional] PBYTE   Buffer,
  [in]           size_t  Size
);

Parameter

[in] hProcess

Ein Handle für einen Prozess. Dieses Handle muss zuvor an die SymInitialize-Funktion übergeben worden sein.

[in] Base

Die Basisadresse des Moduls.

[in, optional] StreamFile

Eine NULL-endende Zeichenfolge, die den absoluten oder relativen Pfad zu einer Datei enthält, die den Quellindizierungsdatenstrom enthält. Kann NULL sein, wenn Buffer nicht NULL ist.

[in, optional] Buffer

Ein Puffer, der den Quellindizierungsdatenstrom enthält. Kann NULL sein, wenn StreamFile nicht NULL ist.

[in] Size

Größe des Pufferpuffers in Bytes.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert TRUE.

Wenn die Funktion fehlschlägt, ist der Rückgabewert FALSE. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen abzurufen.

Hinweise

SymAddSourceStream fügt einem angegebenen Modul einen Datenstrom hinzu, der für die Verwendung durch den Quellserver formatiert ist. Der Aufrufer kann den Stream entweder als Puffer im Buffer-Parameter oder als Datei im StreamFile-Parameter übergeben. Wenn beide Parameter gefüllt sind, verwendet die Funktion den Parameter Buffer . Wenn beide Parameter NULL sind, gibt die Funktion FALSE zurück, und der Code für den letzten Fehler wird auf ERROR_INVALID_PARAMETER festgelegt.

Beachten Sie, dass SymAddSourceStream den Stream keinem entsprechenden PDB hinzufügt, um die Daten dauerhaft zu speichern. Diese Funktion wird von denjenigen verwendet, die ihre eigenen Debugger programmgesteuert in Szenarien implementieren, in denen kein PDB verfügbar ist.

Anforderungen

Anforderung	Wert
Zielplattform	Windows
Kopfzeile	dbghelp.h
Bibliothek	Dbghelp.lib
DLL	Dbghelp.dll
Verteilbare Komponente	DbgHelp.dll 6.8 oder höher

Freigeben über