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

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

  • Статья

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

Синтаксис

BOOL IMAGEAPI SymAddSourceStreamW(
  [in]           HANDLE  hProcess,
  [in]           ULONG64 Base,
                 PCWSTR  FileSpec,
  [in, optional] PBYTE   Buffer,
  [in]           size_t  Size
);

Параметры

[in] hProcess

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

[in] Base

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

FileSpec

Строка, завершающаяся значением 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 недоступен.

Примечание

Заголовок dbghelp.h определяет SymAddSourceStream в качестве псевдонима, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора UNICODE. Сочетание использования псевдонима, не зависящий от кодировки, с кодом, не зависящим от кодировки, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в разделе Соглашения для прототипов функций.

Требования

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