Функция 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 или более поздней версии |