更新:2007 年 11 月
给定一个元数据接口和一个文件名,返回将读取与该模块关联的调试符号的正确 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 或某个其他错误代码。
要求
**头文件:**CorSym.idl
备注
该方法的此版本可在不与该模块相邻的区域中搜索 PDB 文件。搜索策略可通过组合 CorSymSearchPolicyAttributes 进行控制。例如,AllowReferencePathAccess | AllowSymbolServerAccess 查找与可执行文件相邻且位于符号服务器上的 PDB,但是不查询注册表或使用可执行文件中的路径。如果提供了 searchPath 参数,则将总是搜索这些目录。