Método ISymUnmanagedBinder2::GetReaderForFile2

Artigo
06/08/2023

Tendo em conta uma interface de metadados e um nome de ficheiro, devolve a interface ISymUnmanagedReader correta que lerá os símbolos de depuração associados ao módulo.

Este método fornece uma pesquisa mais extensa para o ficheiro de base 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 de importação de metadados.

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

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

searchPolicy
[in] Um valor da enumeração CorSymSearchPolicyAttributes que especifica a política a utilizar ao procurar um leitor de símbolos.

pRetVal
[fora] Um ponteiro definido para a interface ISymUnmanagedReader devolvida.

Devolver Valor

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

Requisitos

Cabeçalho: CorSym.idl, CorSym.h

Observações

Esta versão do método pode procurar o ficheiro PDB em áreas que não estejam ao lado do módulo. A política de pesquisa pode ser controlada ao combinar CorSymSearchPolicyAttributes. Por exemplo, AllowReferencePathAccess | AllowSymbolServerAccess procura o PDB junto ao ficheiro executável e num servidor de símbolos, mas não consulta o registo nem utiliza o caminho no ficheiro executável. Se o searchPath parâmetro for fornecido, esses diretórios serão sempre procurados.

Partilhar via