SymGetFileLineOffsets64 函式 (dbghelp.h)
找出指定模組和檔名的行資訊。
語法
ULONG IMAGEAPI SymGetFileLineOffsets64(
[in] HANDLE hProcess,
[in, optional] PCSTR ModuleName,
[in] PCSTR FileName,
[out] PDWORD64 Buffer,
[in] ULONG BufferLines
);
參數
[in] hProcess
原本傳遞至 SymInitialize 函式之進程的句柄。
[in, optional] ModuleName
要在其中放置行的模組名稱。 如果此參數為 NULL,函式會搜尋所有模組。
[in] FileName
要在其中放置行的檔名。
[out] Buffer
每一行的位移陣列。 第 n 行的位移會儲存在元素 n-1 中。 沒有行資訊的行陣列元素會保持不變。
[in] BufferLines
Buffer 陣列的大小,以元素為單位。
傳回值
如果函式成功,傳回值會是找到的最高行號。 如果找不到任何行資訊,則此值為零。
如果函式失敗,傳回值會LINE_ERROR。 若要擷取擴充的錯誤資訊,請呼叫 GetLastError。
備註
所有 DbgHelp 函式,例如此函式都是單個線程。 因此,從一個以上的線程呼叫此函式可能會導致非預期的行為或記憶體損毀。 若要避免這種情況,您必須將所有並行呼叫從一個以上的線程同步至此函式。
規格需求
需求 | 值 |
---|---|
目標平台 | Windows |
標頭 | dbghelp.h |
程式庫 | Dbghelp.lib |
Dll | Dbghelp.dll |
可轉散發套件 | DbgHelp.dll 5.1 或更新版本 |