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

Статья
11/20/2024

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

Синтаксис

BOOL IMAGEAPI SymAddSourceStreamA(
  [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 добавляет поток данных, отформатированный для использования исходного сервера в назначенный модуль. Вызывающий объект может передать поток в качестве буфера в параметре буфера или файл в параметре StreamFile . Если оба параметра заполнены, функция использует параметр buffer. Если оба параметра null, функция возвращает FALSE, а код последней ошибки имеет значение ERROR_INVALID_PARAMETER.

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

Заметка

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

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Сборка Windows 10 20348
минимальный поддерживаемый сервер	Сборка Windows 10 20348
целевая платформа	Виндоус
заголовка	dbghelp.h
библиотеки	Dbghelp.lib
DLL	Dbghelp.dll
распространяемый	DbgHelp.dll 6.8 или более поздней версии

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