Freigeben über


ICLRRuntimeHost::ExecuteApplication-Methode

Wird in manifestbasierten -Szenarien der ClickOnce-Bereitstellung zum Angeben der Anwendung verwendet, die in einer neuen Domäne aktiviert werden soll. Weitere Informationen zu diesen Szenarien finden Sie unter ClickOnce-Sicherheit und Bereitstellung.

HRESULT ExecuteApplication(
    [in] LPCWSTR   pwzAppFullName,
    [in] DWORD     dwManifestPaths,
    [in] LPCWSTR   *ppwzManifestPaths,
    [in] DWORD     dwActivationData,
    [in] LPCWSTR   *ppwzActivationData,
    [out] int      *pReturnValue
);

Parameter

  • pwzAppFullName
    [in] Der vollständige Name der Anwendung, der für ApplicationIdentity definiert wurde.

  • dwManifestPaths
    [in] Die Anzahl der Zeichenfolgen, die im ppwzManifestPaths-Array enthalten sind.

  • ppwzManifestPaths
    [in] Optional. Ein Zeichenfolgenarray, das die Manifestpfade für die Anwendung enthält.

  • dwActivationData
    [in] Die Anzahl der Zeichenfolgen, die im ppwzActivationData-Array enthalten sind.

  • ppwzActivationData
    [in] Optional. Ein Zeichenfolgenarray, das die Aktivierungsdaten der Anwendung enthält, wie den Abfragezeichenfolgenteil für die URL von Anwendungen, die über das Web bereitgestellt werden.

  • pReturnValue
    [out] Der Wert, der vom Einstiegspunkt der Anwendung zurückgegeben wurde.

Rückgabewert

HRESULT

Beschreibungen

S_OK

ExecuteApplication erfolgreich zurückgegeben.

HOST_E_CLRNOTAVAILABLE

Die Common Language Runtime (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

ExecuteApplication wird verwendet, um ClickOnce-Anwendungen in einer neu erstellten Anwendungsdomäne zu aktivieren.

Der pReturnValue-Ausgabeparameter wird auf den von der Anwendung zurückgegebenen Wert festgelegt. Wenn der Wert NULL für pReturnValue festgelegt wird, schlägt ExecuteApplication zwar nicht fehl, gibt aber keinen Wert zurück.

Wichtiger HinweisWichtig

Die ICLRRuntimeHost::Start-Methode-Methode sollte nicht vor dem Aufruf der ExecuteApplication-Methode aufgerufen werden, um eine manifestbasierte Anwendung zu aktivieren.Wenn die Start-Methode zuerst aufgerufen wird, schlägt der ExecuteApplication-Methodenaufruf fehl.

Anforderungen

Plattformen: siehe Systemanforderungen für .NET Framework.

Header: MSCorEE.h

Bibliothek: als Ressource in MSCorEE.dll enthalten

.NET Framework-Versionen: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Siehe auch

Aufgaben

Exemplarische Vorgehensweise: Bedarfsgerechtes Herunterladen von Assemblys mit der API für die ClickOnce-Bereitstellung unter Verwendung des Designers

Referenz

ActivationContext

AppDomainManager

ApplicationIdentity

ICLRRuntimeHost-Schnittstelle

IHostControl::SetAppDomainManager-Methode

Konzepte

Übersicht über Hosting