IDebugSymbols3::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。 如果 緩衝區NULL,則不會傳回此資訊。
[in] BufferLines
指定 Buffer 陣列可以保存的PULONG64物件數目。
[out, optional] FileLines
接收 File所指定來源檔案中的行數。
傳回值
這個方法也可以傳回錯誤值。 如需詳細資訊,請參閱 傳回值。
傳回碼 | 描述 |
---|---|
|
方法成功。 |
|
方法成功。 不過,原始程式檔中的行數超過 Buffer 陣列中的項目數目,並捨棄了部分結果。 |
言論
如需使用來源路徑的詳細資訊,請參閱 使用原始程式檔。
要求
要求 | 價值 |
---|---|
目標平臺 | 桌面 |
標頭 | dbgeng.h (include Dbgeng.h) |