Funzione SymAddSourceStream (dbghelp.h)

Articolo
03/13/2024

Aggiunge il flusso al modulo specificato per l'uso da parte del server di origine.

Sintassi

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

Parametri

[in] hProcess

Handle di un processo. Questo handle deve essere stato passato in precedenza alla funzione SymInitialize .

[in] Base

Indirizzo di base del modulo.

[in, optional] StreamFile

Stringa con terminazione Null contenente il percorso assoluto o relativo di un file che contiene il flusso di indicizzazione di origine. Può essere NULL se Buffer non è NULL.

[in, optional] Buffer

Buffer contenente il flusso di indicizzazione di origine. Può essere NULL se StreamFile non è NULL.

[in] Size

Dimensioni, in byte, del buffer buffer .

Valore restituito

Se la funzione ha esito positivo, il valore restituito è TRUE.

Se la funzione ha esito negativo, il valore restituito è FALSE. Per recuperare informazioni sull'errore estese, chiamare GetLastError.

Commenti

SymAddSourceStream aggiunge un flusso di dati formattato per l'uso dal server di origine a un modulo designato. Il chiamante può passare il flusso come buffer nel parametro Buffer o in un file nel parametro StreamFile . Se vengono compilati entrambi i parametri, la funzione usa il parametro Buffer . Se entrambi i parametri sono NULL, la funzione restituisce FALSE e il codice di ultimo errore è impostato su ERROR_INVALID_PARAMETER.

È importante notare che SymAddSourceStream non aggiunge il flusso a un PDB corrispondente per rendere persistenti i dati. Questa funzione viene usata da coloro che implementano a livello di codice i propri debugger in scenari in cui un PDB non è disponibile.

Requisiti

Requisito	Valore
Piattaforma di destinazione	Windows
Intestazione	dbghelp.h
Libreria	Dbghelp.lib
DLL	Dbghelp.dll
Componente ridistribuibile	DbgHelp.dll 6.8 o versione successiva

Condividi tramite