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

接收请求的符号信息。 返回的数据类型取决于 Which 的值。 如果 Buffer 为 NULL，则不返回此信息。

[in] BufferSize

指定 缓冲区 的大小（以字节为单位）。 如果 Buffer 为 NULL， 则 BufferSize 也必须为 NULL。

[out, optional] InfoSize

指定返回给 缓冲区 的信息的大小（以字节为单位）。 如果不需要数据，此参数可以为 NULL 。

返回值

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

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

注解

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

要求

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

另请参阅

FindSourceFileAndToken

IDebugAdvanced2

IDebugAdvanced3