ICLRRuntimeHost::ExecuteApplication 메서드

아티클
08/09/2011

새 도메인에서 활성화될 응용 프로그램을 지정하기 위해 매니페스트 기반의 ClickOnce 배포 시나리오에서 사용됩니다. 이러한 시나리오에 대한 자세한 내용은 ClickOnce 보안 및 배포를 참조하십시오.

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

매개 변수

pwzAppFullName
[in] ApplicationIdentity에 정의된 응용 프로그램의 전체 이름입니다.
dwManifestPaths
[in] ppwzManifestPaths 배열에 포함된 문자열의 수입니다.
ppwzManifestPaths
[in] 선택적 요소. 응용 프로그램의 매니페스트 경로를 포함하는 문자열 배열입니다.
dwActivationData
[in] ppwzActivationData 배열에 포함된 문자열의 수입니다.
ppwzActivationData
[in] 선택적 요소. 웹을 통해 배포되는 응용 프로그램에 대한 URL의 쿼리 문자열 부분과 같이 응용 프로그램의 활성화 데이터를 포함하는 문자열 배열입니다.
pReturnValue
[out] 응용 프로그램의 진입점에서 반환된 값입니다.

반환 값

HRESULT	설명
S_OK	ExecuteApplication에서 성공적으로 반환되었습니다.
HOST_E_CLRNOTAVAILABLE	CLR(공용 언어 런타임)이 프로세스에 로드되지 않았거나 관리 코드를 실행할 수 없는 상태 또는 호출을 처리할 수 없는 상태입니다.
HOST_E_TIMEOUT	호출 시간이 초과되었습니다.
HOST_E_NOT_OWNER	호출자가 잠금을 소유하고 있지 않습니다.
HOST_E_ABANDONED	차단된 스레드나 파이버가 기다리던 이벤트가 취소되었습니다.
E_FAIL	알 수 없는 치명적인 오류가 발생했습니다. 메서드가 E_FAIL을 반환하는 경우 프로세스에서 CLR을 더 이상 사용할 수 없습니다. 이후에 호스팅 메서드를 호출하면 HOST_E_CLRNOTAVAILABLE이 반환됩니다.

설명

ExecuteApplication은 새로 만든 응용 프로그램 도메인에서 ClickOnce 응용 프로그램을 활성화하는 데 사용됩니다.

pReturnValue 출력 매개 변수는 응용 프로그램에서 반환한 값으로 설정됩니다. pReturnValue에 null 값을 지정하면 ExecuteApplication에서 오류가 발생하지는 않지만 값이 반환되지도 않습니다.

중요
ICLRRuntimeHost::Start 메서드 메서드를 호출하려면 먼저 ExecuteApplication 메서드를 호출하여 매니페스트 기반 응용 프로그램을 활성화해야 합니다.Start 메서드를 먼저 호출하면 ExecuteApplication 메서드를 호출할 때 오류가 발생합니다.

요구 사항

플랫폼: .NET Framework 시스템 요구 사항 참조

헤더: MSCorEE.h

라이브러리: MSCorEE.dll에 리소스로 포함됨

.NET Framework 버전: 4, 3.5 SP1, 3.5, 3.0 SP1, 3.0, 2.0 SP1, 2.0

참고 항목

다음을 통해 공유

ICLRRuntimeHost::ExecuteApplication 메서드

매개 변수

반환 값

설명

요구 사항

참고 항목

작업

참조

개념

추가 리소스