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 此参数。

返回值

此方法也可能返回错误值。 有关详细信息,请参阅 返回值

返回代码 描述
S_OK
该方法成功。
S_FALSE
该方法成功。 但是,信息不适合 缓冲区 缓冲区中,因此信息或名称被截断。

言论

有关源文件的详细信息,请参阅 使用源文件

要求

要求 价值
目标平台 桌面
标头 dbgeng.h (包括 Dbgeng.h)

另请参阅

FindSourceFileAndToken

IDebugAdvanced2

IDebugAdvanced3