ISymUnmanagedBinder2::GetReaderForFile2-Methode

Gibt bei Angabe einer Metadatenschnittstelle und eines Dateinamens die richtige ISymUnmanagedReader-Schnittstelle zurück, die die dem Modul zugeordneten Debugsymbole liest.

Diese Methode stellt umfangreichere Suchfunktionen für die Programmdatenbankdatei (PDB) bereit als die ISymUnmanagedBinder::GetReaderForFile-Methode.

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 Schnittstelle für den Metadatenimport.

• fileName
  [in] Ein Zeiger auf den Dateinamen.

• searchPath
  [in] Ein Zeiger auf den Suchpfad.

• searchPolicy
  [in] Ein Wert der CorSymSearchPolicyAttributes-Enumeration, der angibt, welche Richtlinie bei der Suche nach einem Symbolreader verwendet werden soll.

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

Rückgabewert

S_OK, wenn die Methode erfolgreich ausgeführt wurde, andernfalls E_FAIL oder ein anderer Fehlercode.

Anforderungen

Header: CorSym.idl, CorSym.h

Hinweise

Diese Version der Methode kann die Programmdatenbankdatei in anderen Bereichen als in unmittelbarer Nähe des Moduls suchen. Die Suchrichtlinie kann durch Kombination von CorSymSearchPolicyAttributes gesteuert werden. Beispielsweise sucht AllowReferencePathAccess | AllowSymbolServerAccess die PDB-Datei direkt bei der ausführbaren Datei und auf einem Symbolserver, fragt jedoch nicht die Registrierung ab und verwendet nicht den Pfad in der ausführbaren Datei. Wenn der searchPath-Parameter bereitgestellt wird, werden diese Verzeichnisse immer durchsucht.

Siehe auch

Referenz

ISymUnmanagedBinder2-Schnittstelle

ISymUnmanagedBinder::GetReaderForFile-Methode