IDebugSymbols2::GetSourceFileLineOffsets 方法 (dbgeng.h)

GetSourceFileLineOffsets方法會將來源檔案中的每個行對應至目標記憶體中的位置。

語法

HRESULT GetSourceFileLineOffsets(
  [in]            PCSTR    File,
  [out, optional] PULONG64 Buffer,
  [in]            ULONG    BufferLines,
  [out, optional] PULONG   FileLines
);

參數

[in] File

指定檔案的名稱,其行將會轉換成目標記憶體中的位置。 系統會針對此檔案查詢目標中每個模組的符號。 如果檔案找不到,則會卸載路徑,並重新查詢符號。

[out, optional] Buffer

接收目標記憶體中對應至源程式碼的位置。 傳回此陣列的第一個專案會對應至檔案的第一行,以便 Buffer[i] 包含行 i+1 的位置。 如果一行沒有可用的符號資訊, Buffer 中的對應專案會設定為DEBUG_INVALID_OFFSET。 如果 BufferNull,則不會傳回此資訊。

[in] BufferLines

指定 Buffer 陣列可以保存的 PULONG64 物件數目。

[out, optional] FileLines

接收 File所指定原始程式檔中的行數。

傳回值

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

傳回碼 描述
S_OK
此方法成功。
S_FALSE
此方法成功。 不過,原始程式檔中的行數超過 Buffer 陣列中的專案數目,而部分結果會被捨棄。

備註

如需使用來源路徑的詳細資訊,請參閱 使用來源檔案

規格需求

   
目標平臺 桌面
標頭 dbgeng.h (包含 Dbgeng.h)

另請參閱

FindSourceFile

GetSourceEntriesByLine

IDebugSymbols

IDebugSymbols2

IDebugSymbols3