Condividi tramite


Metodo ICLRRuntimeHost::ExecuteApplication

Utilizzato negli scenari di distribuzione ClickOnce basati su manifesto per specificare l'applicazione che deve essere attivata in un nuovo dominio. Per ulteriori informazioni su questi scenari, vedere Sicurezza e distribuzione di ClickOnce.

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 matrice ppwzManifestPaths.

  • ppwzManifestPaths
    [in] Facoltativo. Matrice di stringhe contenente i percorsi dei manifesti dell'applicazione.

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

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

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

Valore restituito

HRESULT

Oggetto di descrizione

S_OK

ExecuteApplication ha restituito correttamente un valore.

HOST_E_CLRNOTAVAILABLE

Common Language Runtime non è stato caricato in un processo oppure si trova in uno stato in cui non è possibile eseguire codice gestito né elaborare correttamente la chiamata.

HOST_E_TIMEOUT

Timeout della chiamata.

HOST_E_NOT_OWNER

Il chiamante non è il proprietario del blocco.

HOST_E_ABANDONED

Un evento è stato annullato mentre un thread o un fiber bloccato era in attesa di tale evento.

E_FAIL

Si è verificato un errore irreversibile sconosciuto. Se un metodo restituisce E_FAIL, Common Language Runtime non sarà più utilizzabile all'interno del processo. Le successive chiamate ai metodi di hosting restituiranno HOST_E_CLRNOTAVAILABLE.

Note

ExecuteApplication è utilizzato per attivare applicazioni ClickOnce in un dominio applicazione appena creato.

Il parametro di output pReturnValue viene impostato sul valore restituito dall'applicazione. Se si specifica un valore null per il parametro pReturnValue, il metodo ExecuteApplication non avrà esito negativo, ma non restituirà alcun valore.

Nota importanteImportante

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

Requisiti

Piattaforme: vedere Requisiti di sistema di .NET Framework.

Intestazione: MSCorEE.h

Libreria: inclusa come risorsa in MSCorEE.dll

Versioni di .NET Framework: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

Vedere anche

Attività

Procedura dettagliata: download di assembly su richiesta con l'API della distribuzione ClickOnce tramite la finestra di progettazione

Riferimenti

ActivationContext

AppDomainManager

ApplicationIdentity

Interfaccia ICLRRuntimeHost

Metodo IHostControl::SetAppDomainManager

Concetti

Cenni preliminari sull'hosting