IDebugAdvanced2：：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 是 NULL，BufferSize 也必須是 NULL。

[out, optional] InfoSize

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

傳回值

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

傳回碼	描述
S_OK	此方法成功。
S_FALSE	此方法成功。 不過，資訊並不符合 緩衝區 緩衝區，因此會截斷資訊或名稱。

備註

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

規格需求

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

另請參閱

FindSourceFileAndToken

IDebugAdvanced2

IDebugAdvanced3