Freigeben über

ICLRRuntimeHost::ExecuteApplication-Methode

  • Artikel

Aktualisiert: November 2007

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-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

Beschreibung

S_OK

ExecuteApplication kehrte erfolgreich zurück.

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.

ms164409.alert_caution(de-de,VS.90).gifWichtiger Hinweis:

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.idl

Bibliothek: als Ressource in MSCorEE.dll enthalten

.NET Framework-Versionen: 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

IHostControl::SetAppDomainManager-Methode

Weitere Ressourcen

Bereitstellen der Common Language Runtime