IDebugSymbols3：：GetSourceFileLineOffsets 方法 (dbgeng.h)

發行項
02/23/2024

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。如果 Buffer 是 NULL，則不會傳回這項資訊。

[in] BufferLines

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

[out, optional] FileLines

接收 File 所指定來源檔案中的行數。

傳回值

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

傳回碼	描述
S_OK	此方法成功。
S_FALSE	此方法成功。不過，原始程序檔中的行數超過 Buffer 陣列中的項目數目，而部分結果已捨棄。