ICLRAssemblyIdentityManager::GetReferencedAssembliesFromFile-Methode

Artikel
06/04/2023

Ruft eine ICLRReferenceAssemblyEnum-Instanz ab, die eine Liste von Assemblys enthält, auf die die Assembly im angegebenen Dateipfad verweist.

Syntax

HRESULT GetReferencedAssembliesFromFile (  
    [in]  LPCWSTR pwzFilePath,  
    [in]  DWORD   dwFlags,  
    [in]  ICLRAssemblyReferenceList   *pExcludeAssembliesList,  
    [out] ICLRReferenceAssemblyEnum  **ppReferenceEnum  
);

Parameter

pwzFilePath
[in] Der Pfad zur auszuwertenden Assembly.

dwFlags
[in] Für künftige Erweiterungen bereitgestellt. CLR_ASSEMBLY_IDENTITY_FLAGS_DEFAULT ist der einzige Wert, den die aktuelle Version der Common Language Runtime (CLR) unterstützt.

pExcludeAssembliesList
[in] Ein Zeiger auf ein ICLRAssemblyReferenceList-Objekt, das Assemblys repräsentiert, die von ppReferenceEnum ausgeschlossen werden sollen.

ppReferenceEnum
[out] Ein Zeiger auf die Adresse eines ICLRReferenceAssemblyEnum-Objekts, das Assemblyidentitätsdaten für die Assemblys enthält, auf die die Assembly bei pwzFilePath verweist, mit Ausnahme der Assemblys, die durch pExcludeAssembliesList dargestellt werden.

Rückgabewert

HRESULT	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich zurückgegeben.
HOST_E_CLRNOTAVAILABLE	Die CLR wurde nicht in einen Prozess geladen, oder die CLR befindet sich in einem Zustand, in dem sie keinen verwalteten Code ausführen oder den Aufruf nicht erfolgreich verarbeiten kann.
HOST_E_TIMEOUT	Timeout des Aufrufs.
HOST_E_NOT_OWNER	Der Aufrufer besitzt die Sperre nicht.
HOST_E_ABANDONED	Ein Ereignis wurde abgebrochen, während ein blockierter Thread oder eine blockierte Fiber darauf gewartet hat.
E_FAIL	Es ist ein unbekannter katastrophaler Fehler aufgetreten. Wenn eine Methode E_FAIL zurückgibt, kann die CLR nicht mehr innerhalb des Prozesses verwendet werden. Nachfolgende Aufrufe von Hostingmethoden geben HOST_E_CLRNOTAVAILABLE zurück.

Bemerkungen

Der Aufrufer kann festlegen, dass eine Reihe von bekannten Assemblyverweisen aus der zurückgegebenen Liste ausgeschlossen werden soll. Diese Reihe wird durch den pExcludeAssembliesList-Parameter definiert.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: MSCorEE.h

Bibliothek: Als Ressource in „MsCorEE.dll“ enthalten.

.NET Framework-Versionen: Seit 2.0 verfügbar.

Freigeben über