Partager via


ISymUnmanagedBinder2::GetReaderForFile2, méthode

À partir d’une interface de métadonnées et d’un nom de fichier, retourne l’interface ISymUnmanagedReader appropriée qui lira les symboles de débogage associés au module.

Cette méthode permet une recherche plus étendue du fichier PDB (base de données de programme) que la recherche de la méthode ISymUnmanagedBinder::GetReaderForFile.

Syntaxe

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

Paramètres

importer
[in] Pointeur vers l’interface d’importation de métadonnées.

fileName
[in] Pointeur vers le nom de fichier.

searchPath
[in] Pointeur vers le chemin de recherche.

searchPolicy
[in] Valeur de l’énumération CorSymSearchPolicyAttributes, qui spécifie la stratégie à utiliser pour la recherche d’un lecteur de symboles.

pRetVal
[out] Pointeur défini sur l’interface ISymUnmanagedReader retournée.

Valeur renvoyée

S_OK en cas de réussite de la méthode ; sinon, E_FAIL ou un autre code d’erreur.

Configuration requise

En-tête : CorSym.idl, CorSym.h

Remarques

Cette version de la méthode peut rechercher le fichier PDB ailleurs qu’à proximité immédiate du module. La stratégie de recherche peut être contrôlée en combinant CorSymSearchPolicyAttributes. Par exemple, AllowReferencePathAccess | AllowSymbolServerAccess recherche le PDB à proximité du fichier exécutable et sur un serveur de symboles, mais n’interroge pas le registre et n’utilise pas le chemin dans le fichier exécutable. Si le paramètre searchPath est fourni, ces répertoires feront toujours l’objet de recherches.

Voir aussi