ICLRAssemblyIdentityManager::GetBindingIdentityFromFile-Methode

2011-08-10

Ruft die Assemblyidentitätsbindungsdaten der Assembly im angegebenen Dateipfad ab.

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

Parameter

pwzFilePath
[in] Der Pfad zur Datei, die ausgewertet werden soll.
dwFlags
[in] Ein Wert der ECLRAssemblyIdentityFlags-Enumeration, der den Typ einer Assemblyidentität angibt. Reserviert für zukünftige Erweiterungen. CLR_ASSEMBLY_IDENTITY_FLAGS_DEFAULT ist der einzige von Version 2.0 der Common Language Runtime (CLR) unterstützte Wert.
pwzBuffer
[out] Ein Puffer, der die nicht transparenten Assemblyidentitätsdaten enthält.
pcchBufferSize
[in, out] Ein Zeiger auf die Größe von pwzBuffer.

Rückgabewert

HRESULT	Beschreibungen
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 befindet sich in einem Zustand, in dem sie weder verwalteten Code ausführen noch den Aufruf erfolgreich verarbeiten kann.
HOST_E_TIMEOUT	Der Aufruf hat das Zeitlimit überschritten.
HOST_E_NOT_OWNER	Der Aufrufer ist nicht Besitzer der Sperre.
HOST_E_ABANDONED	Ein Ereignis wurde abgebrochen, während ein blockierter Thread oder eine blockierte Fiber auf das Ereignis gewartet hat.
E_FAIL	Ein unbekannter, schwerwiegender Fehler ist aufgetreten. Wenn eine Methode E_FAIL zurückgibt, kann die CLR innerhalb des Prozesses nicht mehr verwendet werden. Nachfolgende Aufrufe von Hostmethoden geben HOST_E_CLRNOTAVAILABLE zurück.

Hinweise

GetBindingIdentityFromFile wird normalerweise zweimal aufgerufen. Der erste Aufruf stellt einen NULL-Wert für pwzBuffer bereit, und die Methode gibt die entsprechende Größe in *pcchBufferSize zurück. Der zweite Aufruf stellt einen entsprechend reservierten Puffer bereit, und die Methode gibt nach Abschluss des Vorgangs die tatsächlichen Pufferdaten zurück.