ICLRRuntimeHost::ExecuteApplication — Metoda

  • Artykuł

Używany w scenariuszach wdrażania technologii ClickOnce opartych na manifeście w celu określenia aplikacji do aktywowania w nowej domenie. Aby uzyskać więcej informacji na temat tych scenariuszy, zobacz Temat ClickOnce Security and Deployment (Zabezpieczenia i wdrażanie technologii ClickOnce).

Składnia

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

Parametry

pwzAppFullName
[in] Pełna nazwa aplikacji, zgodnie z definicją dla ApplicationIdentityelementu .

dwManifestPaths
[in] Liczba ciągów zawartych w tablicy ppwzManifestPaths .

ppwzManifestPaths
[in] Opcjonalne. Tablica ciągów zawierająca ścieżki manifestu dla aplikacji.

dwActivationData
[in] Liczba ciągów zawartych w tablicy ppwzActivationData .

ppwzActivationData
[in] Opcjonalne. Tablica ciągów zawierająca dane aktywacji aplikacji, takie jak część ciągu zapytania adresu URL dla aplikacji wdrożonych w Sieci Web.

pReturnValue
[out] Wartość zwrócona z punktu wejścia aplikacji.

Wartość zwracana

HRESULT Opis
S_OK ExecuteApplication zwrócone pomyślnie.
HOST_E_CLRNOTAVAILABLE Środowisko uruchomieniowe języka wspólnego (CLR) nie zostało załadowane do procesu lub clR jest w stanie, w którym nie może uruchomić kodu zarządzanego ani pomyślnie przetworzyć wywołania.
HOST_E_TIMEOUT Upłynął limit czasu wywołania.
HOST_E_NOT_OWNER Obiekt wywołujący nie jest właścicielem blokady.
HOST_E_ABANDONED Zdarzenie zostało anulowane, gdy zablokowany wątek lub światłowod czekał na nie.
E_FAIL Wystąpił nieznany katastrofalny błąd. Jeśli metoda zwróci E_FAIL, clR nie będzie już można jej używać w ramach tego procesu. Kolejne wywołania metod hostingu zwracają HOST_E_CLRNOTAVAILABLE.

Uwagi

ExecuteApplication służy do aktywowania aplikacji ClickOnce w nowo utworzonej domenie aplikacji.

Parametr pReturnValue wyjściowy jest ustawiany na wartość zwróconą przez aplikację. Jeśli podasz wartość null dla pReturnValue, ExecuteApplication nie powiedzie się, ale nie zwraca wartości.

Ważne

Nie należy wywoływać metody Start przed wywołaniem metody w ExecuteApplication celu aktywowania aplikacji opartej na manifeście. Jeśli metoda jest wywoływana StartExecuteApplication jako pierwsza, wywołanie metody zakończy się niepowodzeniem.

Wymagania

Platformy: Zobacz Wymagania systemowe.

Nagłówka: MSCorEE.h

Biblioteki: Uwzględnione jako zasób w MSCorEE.dll

wersje .NET Framework: dostępne od wersji 2.0

Zobacz też