Поделиться через


Функция SymAddSourceStream (dbghelp.h)

Добавляет поток в указанный модуль для использования исходным сервером.

Синтаксис

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

Параметры

[in] hProcess

Дескриптор процесса. Этот дескриптор должен быть ранее передан в функцию SymInitialize .

[in] Base

Базовый адрес модуля.

[in, optional] StreamFile

Строка, завершающаяся значением NULL, содержащая абсолютный или относительный путь к файлу, который содержит исходный поток индексирования. Может иметь значение NULL, если буфер не равен NULL.

[in, optional] Buffer

Буфер, содержащий исходный поток индексирования. Может иметь значение NULL, если StreamFile не имеет значение NULL.

[in] Size

Размер буфера в байтах.

Возвращаемое значение

Если функция выполняется успешно, возвращается значение TRUE.

Если функция завершается сбоем, возвращается значение FALSE. Чтобы получить расширенные сведения об ошибке, вызовите Метод GetLastError.

Комментарии

SymAddSourceStream добавляет поток данных, отформатированный для использования исходным сервером , в назначенный модуль. Вызывающий объект может передать поток как буфер в параметре Buffer или файл в параметре StreamFile . Если заполнены оба параметра, функция использует параметр Buffer . Если оба параметра имеют значение NULL, функция возвращает значение FALSE , а код последней ошибки имеет значение ERROR_INVALID_PARAMETER.

Важно отметить, что SymAddSourceStream не добавляет поток в соответствующий PDB-файл для сохранения данных. Эта функция используется теми, кто программно реализует собственные отладчики в сценариях, в которых PDB недоступен.

Требования

Требование Значение
Целевая платформа Windows
Header dbghelp.h
Библиотека Dbghelp.lib
DLL Dbghelp.dll
Распространяемые компоненты DbgHelp.dll 6.8 или более поздней версии