ISymUnmanagedBinder2::GetReaderForFile2 Method

Article
09/15/2021

Given a metadata interface and a file name, returns the correct ISymUnmanagedReader interface that will read the debugging symbols associated with the module.

This method provides a more extensive search for the program database (PDB) file than the ISymUnmanagedBinder::GetReaderForFile method.

Syntax

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

Parameters

importer
[in] A pointer to the metadata import interface.

fileName
[in] A pointer to the file name.

searchPath
[in] A pointer to the search path.

searchPolicy
[in] A value of the CorSymSearchPolicyAttributes enumeration that specifies the policy to be used when doing a search for a symbol reader.

pRetVal
[out] A pointer that is set to the returned ISymUnmanagedReader interface.

Return Value

S_OK if the method succeeds; otherwise, E_FAIL or some other error code.

Requirements

Header: CorSym.idl, CorSym.h

Remarks

This version of the method can search for the PDB file in areas other than right next to the module. The search policy can be controlled by combining CorSymSearchPolicyAttributes. For example, AllowReferencePathAccess | AllowSymbolServerAccess looks for the PDB next to the executable file and on a symbol server, but does not query the registry or use the path in the executable file. If the searchPath parameter is provided, those directories will always be searched.

Share via