Método ISymUnmanagedBinder2::GetReaderForFile2

Artigo
06/08/2023

Considerando uma interface de metadados e um nome de arquivo, retorna a interface ISymUnmanagedReader correta que lerá os símbolos de depuração associados ao módulo.

Esse método fornece uma pesquisa mais abrangente para o arquivo de banco de dados do programa (PDB) do que o método ISymUnmanagedBinder::GetReaderForFile.

Sintaxe

HRESULT GetReaderForFile2(  
    [in]  IUnknown     *importer,  
    [in]  const WCHAR  *fileName,  
    [in]  const WCHAR  *searchPath,  
    [in]  ULONG32      searchPolicy,  
    [out,retval] ISymUnmanagedReader  **pRetVal);

Parâmetros

importer
[in] Um ponteiro para a interface do importador de metadados.

fileName
[in] Um ponteiro para o nome do arquivo.

searchPath
[in] Um ponteiro para o caminho de pesquisa.

searchPolicy
[in] Um valor da enumeração CorSymSearchPolicyAttributes que especifica a política a ser usada ao fazer uma pesquisa de um leitor de símbolos.

pRetVal
[out] Um ponteiro definido como a interface ISymUnmanagedReader retornada.

Valor Retornado

S_OK se o método for bem-sucedido, caso contrário, E_FAIL ou algum outro código de erro.

Requisitos

Cabeçalho: CorSym.idl, CorSym.h

Comentários

Essa versão do método pode pesquisar o arquivo PDB em áreas diferentes da direita ao lado do módulo. A política de pesquisa pode ser controlada combinando CorSymSearchPolicyAttributes. Por exemplo, AllowReferencePathAccess | AllowSymbolServerAccess procura o PDB ao lado do arquivo executável e em um servidor de símbolos, mas não consulta o registro nem usa o caminho no arquivo executável. Se o parâmetro searchPath for fornecido, esses diretórios sempre serão pesquisados.

Compartilhar via