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 结尾的字符串,其中包含包含源索引流的文件的绝对路径或相对路径。 如果 Buffer 不为 NULL,可以为 NULL。
[in, optional] Buffer
包含源索引流的缓冲区。 如果 StreamFile 不为 NULL,可以为 NULL。
[in] Size
缓冲区的大小(以字节为单位)。
返回值
如果函数成功,则返回值为 TRUE。
如果函数失败,则返回值为 FALSE。 若要检索扩展的错误信息,请调用 GetLastError。
注解
SymAddSourceStream 将格式化供 源服务器 使用的数据流添加到指定的模块。 调用方可以将流作为 Buffer 参数中的缓冲区或 StreamFile 参数中的文件传递。 如果两个参数都已填充,则该函数将使用 Buffer 参数。 如果两个参数均为 NULL,则该函数返回 FALSE ,最后一个 错误代码 设置为 ERROR_INVALID_PARAMETER。
请务必注意, SymAddSourceStream 不会将流添加到任何相应的 PDB 以持久保存数据。 在 PDB 不可用的情况下,以编程方式实现自己的调试器的用户使用此函数。
要求
要求 | 值 |
---|---|
目标平台 | Windows |
标头 | dbghelp.h |
Library | Dbghelp.lib |
DLL | Dbghelp.dll |
可再发行组件 | DbgHelp.dll 6.8 或更高版本 |