Metodo ICLRRuntimeHost::ExecuteApplication

Articolo
04/08/2023

Usato negli scenari di distribuzione ClickOnce basati su manifesto per specificare l'applicazione da attivare in un nuovo dominio. Per altre informazioni su questi scenari, vedere ClickOnce Security and Deployment.

Sintassi

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

Parametri

pwzAppFullName
[in] Nome completo dell'applicazione, come definito per ApplicationIdentity.

dwManifestPaths
[in] Numero di stringhe contenute nella ppwzManifestPaths matrice.

ppwzManifestPaths
[in] Facoltativo. Matrice di stringhe che contiene percorsi manifesto per l'applicazione.

dwActivationData
[in] Numero di stringhe contenute nella ppwzActivationData matrice.

ppwzActivationData
[in] Facoltativo. Matrice di stringhe che contiene i dati di attivazione dell'applicazione, ad esempio la parte stringa di query dell'URL per le applicazioni distribuite sul Web.

pReturnValue
[out] Valore restituito dal punto di ingresso dell'applicazione.

Valore restituito

HRESULT	Descrizione
S_OK	`ExecuteApplication` restituito correttamente.
HOST_E_CLRNOTAVAILABLE	Common Language Runtime (CLR) non è stato caricato in un processo oppure CLR si trova in uno stato in cui non è possibile eseguire codice gestito o elaborare correttamente la chiamata.
HOST_E_TIMEOUT	Timeout della chiamata.
HOST_E_NOT_OWNER	Il chiamante non possiede il blocco.
HOST_E_ABANDONED	Un evento è stato annullato mentre un thread bloccato o fibra era in attesa su di esso.
E_FAIL	Si è verificato un errore irreversibile sconosciuto. Se un metodo restituisce E_FAIL, CLR non è più utilizzabile all'interno del processo. Le chiamate successive ai metodi di hosting restituiscono HOST_E_CLRNOTAVAILABLE.

Commenti

ExecuteApplication viene usato per attivare le applicazioni ClickOnce in un dominio applicazione appena creato.

Il pReturnValue parametro di output è impostato sul valore restituito dall'applicazione. Se si specifica un valore null per pReturnValue, ExecuteApplication non ha esito negativo, ma non restituisce un valore.

Importante

Non chiamare il metodo Start prima di chiamare il ExecuteApplication metodo per attivare un'applicazione basata su manifesto. Se il metodo viene chiamato prima, la Start chiamata al ExecuteApplication metodo avrà esito negativo.

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: MSCorEE.h

Libreria: Incluso come risorsa in MSCorEE.dll

Versioni di .NET Framework: Disponibile da 2.0

Condividi tramite