SymAddSourceStream
TOC
Collapse the table of content
Expand the table of content

SymAddSourceStream function

Adds the stream to the specified module for use by the Source Server.

Syntax


BOOL WINAPI SymAddSourceStream(
  _In_     HANDLE  hProcess,
  _In_     ULONG64 Base,
  _In_opt_ PCTSTR  StreamFile,
  _In_opt_ PBYTE   Buffer,
  _In_     size_t  Size
);

Parameters

hProcess [in]

A handle to a process. This handle must have been previously passed to the SymInitialize function.

Base [in]

The base address of the module.

StreamFile [in, optional]

A null-terminated string that contains the absolute or relative path to a file that contains the source indexing stream. Can be NULL if Buffer is not NULL.

Buffer [in, optional]

A buffer that contains the source indexing stream. Can be NULL if StreamFile is not NULL.

Size [in]

Size, in bytes, of the Buffer buffer.

Return value

If the function succeeds, the return value is TRUE.

If the function fails, the return value is FALSE. To retrieve extended error information, call GetLastError.

Remarks

SymAddSourceStream adds a stream of data formatted for use by the source Server to a designated module. The caller can pass the stream either as a buffer in the Buffer parameter or a file in the StreamFile parameter. If both parameters are filled, then the function uses the Buffer parameter. If both parameters are NULL, then the function returns FALSE and the last-error code is set to ERROR_INVALID_PARAMETER.

It is important to note that SymAddSourceStream does not add the stream to any corresponding PDB in order to persist the data. This function is used by those programmatically implementing their own debuggers in scenarios in which a PDB is not available.

Requirements

Redistributable

DbgHelp.dll 6.8 or later

Header

Dbghelp.h

Library

Dbghelp.lib

DLL

Dbghelp.dll

Unicode and ANSI names

SymAddSourceStreamW (Unicode) and SymAddSourceStream (ANSI)

 

 

Show:
© 2016 Microsoft