IDebugAdvanced3::GetSourceFileInformation 方法 (dbgeng.h)
GetSourceFileInformation 方法返回有关源文件的指定信息。
语法
HRESULT GetSourceFileInformation(
[in] ULONG Which,
[in] PSTR SourceFile,
[in] ULONG64 Arg64,
[in] ULONG Arg32,
[out, optional] PVOID Buffer,
[in] ULONG BufferSize,
[out, optional] PULONG InfoSize
);
参数
[in] Which
指定要返回的信息片段。 哪个 参数可以采用下表中的值之一。
DEBUG_SRCFILE_SYMBOL_TOKEN
返回一个表示源服务器上的指定源文件的令牌。 此令牌可以传递给 FindSourceFileAndToken 以检索有关文件的信息。 令牌作为字节数组返回到 缓冲区 缓冲区。 此令牌的大小反映了 SrcSrv 令牌的大小。
DEBUG_SRCFILE_SYMBOL_TOKEN_SOURCE_COMMAND_WIDE
查询源服务器以获取从源代码管理中提取源文件的命令。 这包括可执行文件的名称及其命令行参数。 该命令作为 Unicode 字符串返回到 Buffer 缓冲区。
[in] SourceFile
指定要请求其信息的源文件。 源文件在源路径中的所有源服务器上查找。
[in] Arg64
指定 64 位参数。 哪个 的值指定请求其符号标记的模块。 无论 哪个的值,Arg64 是模块内存分配中的一个位置。
[in] Arg32
指定 32 位参数。 此参数当前未使用。
[out, optional] Buffer
接收请求的符号信息。 返回的数据的类型取决于 的值。 如果 缓冲区NULL,则不会返回此信息。
[in] BufferSize
指定 缓冲区 缓冲区的大小(以字节为单位)。 如果 缓冲区NULL,则 BufferSize 也必须 NULL。
[out, optional] InfoSize
指定返回到 缓冲区 缓冲区的信息的大小(以字节为单位)。 如果不需要数据,则可以 NULL 此参数。
返回值
此方法也可能返回错误值。 有关详细信息,请参阅 返回值。
返回代码 | 描述 |
---|---|
|
该方法成功。 |
|
该方法成功。 但是,信息不适合 缓冲区 缓冲区中,因此信息或名称被截断。 |
言论
有关源文件的详细信息,请参阅 使用源文件。
要求
要求 | 价值 |
---|---|
目标平台 | 桌面 |
标头 | dbgeng.h (包括 Dbgeng.h) |