ICLRAssemblyIdentityManager::GetBindingIdentityFromFile-Methode

Artikel
06/02/2023

Ruft die Bindungsdaten der Assemblyidentität für die Assembly am angegebenen Dateipfad ab.

Syntax

HRESULT GetBindingIdentityFromFile(  
    [in] LPCWSTR     pwzFilePath,  
    [in] DWORD       dwFlags,  
    [out, size_is(*pcchBufferSize)] LPWSTR pwzBuffer,  
    [in, out] DWORD *pcchBufferSize  
);

Parameter

pwzFilePath
[in] Der Pfad zur zu bewertenden Datei.

dwFlags
[in] Ein Wert der ECLRAssemblyIdentityFlags-Enumeration , der den Identitätstyp einer Assembly angibt. 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.

pwzBuffer
[out] Ein Puffer, der die opaken Assemblyidentitätsdaten enthält.

pcchBufferSize
[out] Ein Zeiger auf die Größe des pwzBuffer.

Rückgabewert

HRESULT	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich zurückgegeben.
E_INVALIDARG	Der angegebene `pwzFilePath` ist NULL.
ERROR_INSUFFICIENT_BUFFER	Die Größe von `pwzBuffer` ist zu klein.
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

GetBindingIdentityFromFile wird in der Regel zweimal aufgerufen. Der erste Aufruf stellt einen NULL-Wert für pwzBufferbereit, und die -Methode gibt die entsprechende Größe in pcchBufferSizezurück. Der zweite Aufruf stellt einen entsprechend zugeordneten Puffer bereit, und die Methode gibt nach Abschluss die tatsächlichen Pufferdaten zurück.

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