ICLRRuntimeHost::ExecuteApplication-Methode

Artikel
06/08/2023

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

Syntax

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, wie für ApplicationIdentitydefiniert.

dwManifestPaths
[in] Die Anzahl der im ppwzManifestPaths-Array enthaltenen Zeichenfolgen.

ppwzManifestPaths
[in] Optional. Ein Zeichenfolgenarray mit Manifestpfaden für die Anwendung.

dwActivationData
[in] Die Anzahl der im ppwzActivationData-Array enthaltenen Zeichenfolgen.

ppwzActivationData
[in] Optional. Ein Zeichenfolgenarray, das die Aktivierungsdaten der Anwendung enthält. Hierzu zählt beispielsweise der Abfragezeichenfolgenteil der URL für Anwendungen, die über das Web bereitgestellt werden.

pReturnValue
[out] Der vom Einstiegspunkt der Anwendung zurückgegebene Wert.

Rückgabewert

HRESULT	BESCHREIBUNG
S_OK	`ExecuteApplication` wurde erfolgreich zurückgegeben.
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

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 Sie für pReturnValue einen NULL-Wert angeben, tritt für ExecuteApplication kein Fehler auf, es wird aber kein Wert zurückgegeben.

Wichtig

Rufen Sie die Start-Methode nicht auf, bevor Sie die ExecuteApplication-Methode aufrufen, um eine manifestbasierte Anwendung zu aktivieren. Wenn die Start-Methode zuerst aufgerufen wird, ist der Aufruf der ExecuteApplication-Methode nicht erfolgreich.

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