ISymUnmanagedBinder2::GetReaderForFile2 方法

更新: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 参数,则将总是搜索这些目录。

请参见

参考

ISymUnmanagedBinder2

ISymUnmanagedBinder::GetReaderForFile 方法