ISymUnmanagedBinder2::GetReaderForFile2 方法

  • 项目

给定元数据接口和文件名后，返回正确的 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、CorSym.h

备注

此版本的方法可以在模块旁边以外的区域搜索 PDB 文件。 可以通过合并 CorSymSearchPolicyAttributes 控制搜索策略。 例如，AllowReferencePathAccess | AllowSymbolServerAccess 在可执行文件旁和符号服务器上查找 PDB，但不查询注册表或使用可执行文件中的路径。 如果提供了 searchPath 参数，将始终搜索这些目录。

请参阅