ISymUnmanagedBinder2::GetReaderForFile2-Methode

Artikel
06/28/2023

Wenn eine Metadatenschnittstelle und ein Dateiname vorhanden sind, wird die richtige ISymUnmanagedReader-Schnittstelle zurückgegeben, die die dem Modul zugeordneten Debugsymbole liest.

Diese Methode bietet eine umfangreichere Suche nach der Programmdatenbankdatei (PDB) als die ISymUnmanagedBinder::GetReaderForFile-Methode .

Syntax

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

Parameter

importer
[in] Ein Zeiger auf die Metadatenimportschnittstelle.

fileName
[in] Ein Zeiger auf den Dateinamen.

searchPath
[in] Ein Zeiger auf den Suchpfad.

searchPolicy
[in] Ein Wert der CorSymSearchPolicyAttributes-Aufzählung , die die Richtlinie angibt, die beim Suchen nach einem Symbolleser verwendet werden soll.

pRetVal
[out] Ein Zeiger, der auf die zurückgegebene ISymUnmanagedReader-Schnittstelle festgelegt ist.

Rückgabewert

S_OK, wenn die Methode erfolgreich ist, andernfalls E_FAIL oder ein anderer Fehlercode.

Anforderungen

Header: CorSym.idl, CorSym.h

Bemerkungen

Diese Version der Methode kann in anderen Bereichen als direkt neben dem Modul nach der PDB-Datei suchen. Die Suchrichtlinie kann durch die Kombination von CorSymSearchPolicyAttributesgesteuert werden. AllowReferencePathAccess | AllowSymbolServerAccess sucht z. B. neben der ausführbaren Datei und auf einem Symbolserver nach dem PDB, fragt die Registrierung jedoch nicht ab oder verwendet den Pfad in der ausführbaren Datei. Wenn der searchPath-Parameter angegeben wird, werden diese Verzeichnisse immer durchsucht.

Freigeben über