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 字串的形式傳回 緩衝區 緩衝區。

[in] SourceFile

指定要求其資訊的來源檔案。 來源檔案會在來源路徑中的所有來源伺服器上查閱。

[in] Arg64

指定64位自變數。 的值 ， 指定要求符號標記的模組。 不論 其值為何， Arg64 都是模組記憶體配置內的位置。

[in] Arg32

指定32位自變數。 此參數目前未使用。

[out, optional] Buffer

接收要求的符號資訊。 傳回的數據型別取決於 其值。 如果 Buffer 為 NULL，則不會傳回此資訊。

[in] BufferSize

以位元組為單位指定 Buffer 緩衝區的大小。 如果 Buffer 為 NULL，BufferSize 也必須是 NULL。

[out, optional] InfoSize

指定傳回 緩衝區之資訊的 位元元元大小。 如果不需要數據，這個參數可以是 NULL 。

傳回值

這個方法也可能傳回錯誤值。 如需詳細資訊，請參閱 傳回值 。

傳回碼	描述
S_OK	此方法成功。
S_FALSE	此方法成功。 不過，信息無法放入 Buffer 緩衝區中，因此資訊或名稱會被截斷。

備註

如需來源檔案的詳細資訊，請參閱 使用原始程序檔。

規格需求

需求	值
目標平台	桌面
標頭	dbgeng.h (包含 Dbgeng.h)

另請參閱

FindSourceFileAndToken

IDebugAdvanced2

IDebugAdvanced3