Freigeben über

ICLRHostBindingPolicyManager::ModifyApplicationPolicy-Methode

  • Artikel

Ändert die Bindungsrichtlinie für die angegebene Assembly und erstellt eine neue Version der Richtlinie.

Syntax

HRESULT  ModifyApplicationPolicy (  
    [in] LPCWSTR     pwzSourceAssemblyIdentity,
    [in] LPCWSTR     pwzTargetAssemblyIdentity,  
    [in] BYTE       *pbApplicationPolicy,  
    [in] DWORD       cbAppPolicySize,  
    [in] DWORD       dwPolicyModifyFlags,  
    [out, size_is(*pcbNewAppPolicySize)] BYTE *pbNewApplicationPolicy,
    [in, out] DWORD *pcbNewAppPolicySize  
);

Parameter

pwzSourceAssemblyIdentity
[in] Die Identität der zu ändernden Assembly.

pwzTargetAssemblyIdentity
[in] Die neue Identität der geänderten Assembly.

pbApplicationPolicy
[in] Ein Zeiger auf einen Puffer, der Daten zur Bindungsrichtlinie für die zu ändernde Assembly enthält.

cbAppPolicySize
[in] Die Größe der zu ersetzenden Bindungsrichtlinie.

dwPolicyModifyFlags
[in] Eine logische OR-Kombination aus EHostBindingPolicyModifyFlags-Werten, die die Steuerung der Umleitung angibt.

pbNewApplicationPolicy
[out] Ein Zeiger auf einen Puffer, der Daten zur neuen Bindungsrichtlinie enthält.

pcbNewAppPolicySize
[in, out] Ein Zeiger auf die Größe des neuen Bindungsrichtlinienpuffers.

Rückgabewert

HRESULT BESCHREIBUNG
S_OK Die Richtlinie wurde erfolgreich geändert.
E_INVALIDARG pwzSourceAssemblyIdentity oder pwzTargetAssemblyIdentity waren Nullverweise.
ERROR_INSUFFICIENT_BUFFER pbNewApplicationPolicy ist zu klein.
HOST_E_CLRNOTAVAILABLE Die Common Language Runtime (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

Die ModifyApplicationPolicy-Methode kann zweimal aufgerufen werden. Der erste Aufruf sollte einen NULL-Wert für den pbNewApplicationPolicy-Parameter bereitstellen. Dieser Aufruf gibt den erforderlichen Wert für pcbNewAppPolicySize zurück. Der zweite Aufruf sollte diesen Wert für pcbNewAppPolicySize bereitstellen und auf einen Puffer dieser Größe für pbNewApplicationPolicy zeigen.

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.

Siehe auch