IDebugAdvanced3：：GetSourceFileInformation 方法 (dbgeng.h)

發行項
02/25/2024

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