ISymUnmanagedBinder2::GetReaderForFile2 方法
更新:2007 年 11 月
根據指定的中繼資料 (Metadata) 介面和檔名,傳回正確的 ISymUnmanagedReader 介面,它將會讀取與模組相關聯的偵錯符號。
這個方法比 ISymUnmanagedBinder::GetReaderForFile 方法提供更大的程式資料庫 (PDB) 檔案搜尋範圍。
HRESULT GetReaderForFile2(
[in] IUnknown *importer,
[in] const WCHAR *fileName,
[in] const WCHAR *searchPath,
[in] ULONG32 searchPolicy,
[out,retval] ISymUnmanagedReader **pRetVal);
參數
importer
[in] 中繼資料匯入介面的指標。fileName
[in] 檔名的指標。searchPath
[in] 搜尋路徑的指標。searchPolicy
[in] CorSymSearchPolicyAttributes 列舉型別的值,這個值會指定對符號讀取器執行搜尋時所要使用的原則。pRetVal
[out] 指標,設定為傳回的 ISymUnmanagedReader 介面。
傳回值
如果此方法成功則為 S_OK,否則便為 E_FAIL 或其他錯誤碼。
需求
Header: CorSym.idl
備註
這個版本的方法可以在模組旁以外的區域中搜尋 PDB 檔。搜尋原則可藉由合併 CorSymSearchPolicyAttributes 來加以控制。例如,AllowReferencePathAccess | AllowSymbolServerAccess 會在可執行檔旁和符號伺服器上尋找 PDB 檔,但是不會查詢登錄或使用可執行檔中的路徑。如果提供 searchPath 參數,則一定會搜尋這些目錄。