共用方式為

IDiaDataSource::loadDataForExe

  • 發行項

開啟並準備與 .exe/.dll 檔案相關聯的偵錯數據。

語法

HRESULT loadDataForExe (
   LPCOLESTR executable,
   LPCOLESTR searchPath,
   IUnknown* pCallback
);

參數

可執行檔

[in] .exe 或 .dll 檔案的路徑。

searchPath

[in]搜尋偵錯數據的替代路徑。 多個路徑應該以分號分隔。 路徑可能包含尾端 \。

pCallback

[in] 支援偵錯回呼介面之物件的 IUnknown 介面，例如 IDiaLoadCallback、IDiaLoadCallback2、IDiaReadExeAtOffsetCallback 和/或 IDiaReadExeAtRVACallback 介面。

傳回值

如果成功，則會傳回 S_OK；否則，會傳回錯誤碼。 下表顯示此方法的一些可能錯誤碼。

值 Description
E_PDB_NOT_FOUND 無法開啟檔案，或檔案的格式無效。
E_PDB_FORMAT 嘗試存取具有已淘汰格式的檔案。
E_PDB_INVALID_SIG 簽章不相符。
E_PDB_INVALID_AGE 存在時間不相符。
E_INVALIDARG 無效的 參數。
E_UNEXPECTED 資料來源已經備妥。

備註

相關聯偵錯數據位置之檔名的 .exe/.dll 偵錯標頭。

如果您要從符號伺服器載入偵錯數據， symsrv.dll 必須存在於安裝使用者應用程式或 msdia140.dll 的相同目錄中，或者它必須存在於系統目錄中。

此方法會讀取偵錯標頭，然後搜尋並準備偵錯資料。 搜尋進度可選擇性地透過回呼來回報及控制。 例如， IDiaLoadCallback::NotifyDebugDir 當 方法尋找並處理偵錯目錄時 IDiaDataSource::loadDataForExe ，會叫用 。

和 IDiaReadExeAtOffsetCallback IDiaReadExeAtRVACallback 介面可讓用戶端應用程式在無法透過標準檔案 I/O 直接存取檔案時，提供從可執行檔讀取資料的替代方法。

若要載入 .pdb 預先擷取符號記錄的檔案，請使用 IDiaDataSourceEx::loadDataForExeEx 方法。

若要在不驗證的情況下載入 .pdb 檔案，請使用 IDiaDataSource::loadDataFromPdb 方法。

若要根據特定準則驗證 .pdb 檔案，請使用 IDiaDataSource::loadAndValidateDataFromPdb 方法。

若要直接從記憶體載入 .pdb 檔案，請使用 IDiaDataSource::loadDataFromIStream 方法。

若要驗證 .pdb 檔案而不載入它，請使用 IDiaDataSourceEx::ValidatePdb 方法。

範例

class MyCallBack: public IDiaLoadCallback
{
...
};
MyCallBack callback;
...
HRESULT hr = pSource->loadDataForExe( L"myprog.exe", L".\debug", (IUnknown*)&callback);
if (FAILED(hr))
{
    // Report error
}

另請參閱