SymAddSourceStream Function

Debug Help Library

SymAddSourceStream Function

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

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

Parameters

hProcess

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

Base

The base address of the module.

StreamFile

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

Buffer

A buffer that contains additional information (not included in the file) to add to the source stream. Can be NULL if StreamFile is not NULL.

Size

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.

Requirements

Redistributable

Requires DbgHelp.dll 6.8 or later.

Header

Declared in Dbghelp.h.

Library

Use Dbghelp.lib.

DLL

Requires Dbghelp.dll.

Unicode

Implemented as SymAddSourceStreamW (Unicode) and SymAddSourceStream (ANSI).

Send comments about this topic to Microsoft

Build date: 9/25/2007

© 2007 Microsoft Corporation. All rights reserved.