Funzione SymAddSourceStreamA (dbghelp.h)

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

Sintassi

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

Parametri

[in] hProcess

Handle per 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 buffer.

Valore restituito

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

Se la funzione non riesce, il valore restituito viene FALSE. Per recuperare informazioni sull'errore estese, chiamare GetLastError.

Osservazioni

SymAddSourceStream aggiunge un flusso di dati formattato per l'uso da parte del server di origine a un modulo designato. Il chiamante può passare il flusso come buffer nel parametro buffer o come file nel parametro StreamFile . Se entrambi i parametri vengono compilati, 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 ad alcun 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.

Fabbisogno