.NET Framework 초기화 오류: 사용자 환경 관리

CLR(공용 언어 런타임) 활성화 시스템은 관리되는 애플리케이션 코드를 실행하는 데 사용할 CLR 버전을 결정합니다. 경우에 따라 활성화 시스템이 로드할 CLR 버전을 찾지 못할 수도 있습니다. 일반적으로 이런 상황은 애플리케이션에 필요한 CLR 버전이 잘못되었거나 지정된 컴퓨터에 설치되지 않은 경우에 발생합니다. 요청된 버전이 없는 경우 CLR 활성화 시스템은 호출된 함수 또는 인터페이스에서 HRESULT 오류 코드를 반환하며, 애플리케이션을 실행하는 사용자에게 오류 메시지를 표시할 수 있습니다. 이 문서에서는 HRESULT 코드 목록을 제공하며 오류 메시지가 표시되지 않도록 하는 방법을 설명합니다.

방법: CLR 활성화 문제 디버깅에 설명된 대로 CLR은 CLR 활성화 문제를 디버그하는 데 유용한 로깅 인프라를 제공합니다. 이 인프라와 어셈블리 바인딩 로그는 완전히 다르므로 혼동하면 안 됩니다.

CLR 활성화 HRESULT 코드

CLR 활성화 API는 HRESULT 코드를 반환하여 활성화 작업의 결과를 호스트에 보고합니다. CLR 호스트는 추가 작업을 진행하기 전에 이러한 반환 값을 항상 확인해야 합니다.

• CLR_E_SHIM_RUNTIMELOAD

• CLR_E_SHIM_RUNTIMEEXPORT

• CLR_E_SHIM_INSTALLROOT

• CLR_E_SHIM_INSTALLCOMP

• CLR_E_SHIM_LEGACYRUNTIMEALREADYBOUND

• CLR_E_SHIM_SHUTDOWNINPROGRESS

초기화 오류에 대한 UI

CLR 활성화 시스템이 애플리케이션에 필요한 올바른 버전의 런타임을 로드할 수 없는 경우 컴퓨터가 애플리케이션을 실행하도록 제대로 구성되어 있지 않다고 알리는 오류 메시지를 사용자에게 표시하고 문제를 해결할 수 있는 기회를 제공합니다. 이러한 상황에서는 일반적으로 다음과 같은 오류 메시지가 표시됩니다. 사용자는 예를 선택하여 애플리케이션에 맞는 .NET Framework 버전을 다운로드할 수 있는 Microsoft 웹 사이트로 이동할 수 있습니다.

초기화 오류 해결

개발자는 .NET Framework 초기화 오류 메시지를 제어하기 위한 다양한 옵션을 사용할 수 있습니다. 예를 들어 다음 섹션에 설명된 대로 API 플래그를 사용하여 메시지가 표시되지 않도록 방지할 수 있습니다. 그러나 애플리케이션이 요청된 런타임을 로드할 수 없도록 하는 문제를 해결해야 합니다. 해결하지 않으면 애플리케이션이 실행되지 않거나 일부 기능을 사용하지 못할 수도 있습니다.

근본적인 문제를 해결하고 최상의 사용자 환경(적은 오류 메시지)을 제공하려면 다음 권장 사항을 따르세요.

• .NET Framework 3.5(및 이전) 애플리케이션의 경우: .NET Framework 4 이상 버전을 지원하도록 애플리케이션을 구성합니다(지침 참조).

• .NET Framework 4 애플리케이션: 애플리케이션 설치의 일부로 .NET Framework 4 재배포 가능 패키지를 설치합니다. 개발자를 위한 배포 가이드를 참조하세요.

오류 메시지 제어

요청된 .NET Framework 버전을 찾을 수 없다고 알리는 오류 메시지를 표시하는 것은 사용자에 대한 최소한의 불편이나 유용한 서비스로 간주될 수 있습니다. 두 경우 모두 활성화 API에 플래그를 전달하여 이 UI를 제어할 수 있습니다.

ICLRMetaHostPolicy::GetRequestedRuntime 메서드는 METAHOST_POLICY_FLAGS 열거형 멤버를 입력으로 허용합니다. METAHOST_POLICY_SHOW_ERROR_DIALOG 플래그를 포함하면 요청된 버전의 CLR을 찾을 수 없는 경우 오류 메시지를 요청할 수 있습니다. 기본적으로 오류 메시지는 표시되지 않습니다. ICLRMetaHost::GetRuntime 메서드는 이 플래그를 허용하지 않으며 오류 메시지를 표시하는 다른 방법도 제공하지 않습니다.

Windows에서는 프로세스 내에서 실행되는 코드의 결과로 오류 메시지를 표시할지 여부를 선언하는 데 사용할 수 있는 SetErrorMode 함수를 제공합니다. SEM_FAILCRITICALERRORS 플래그를 지정하면 오류 메시지가 표시되지 않도록 방지할 수 있습니다.

그러나 일부 시나리오에서는 애플리케이션 프로세스에서 지정한 SEM_FAILCRITICALERRORS 설정을 재정의하는 것이 중요합니다. 예를 들어 CLR을 호스트하고 SEM_FAILCRITICALERRORS가 설정되어 있는 프로세스에 호스트된 네이티브 COM 구성 요소가 있는 경우 해당 특정 애플리케이션 프로세스 내에서 오류 메시지를 표시할 경우의 영향에 따라 플래그를 재정의하는 것이 좋습니다. 이 경우 다음 플래그 중 하나를 사용하여 SEM_FAILCRITICALERRORS를 재정의할 수 있습니다.

• ICLRMetaHostPolicy::GetRequestedRuntime 메서드에 METAHOST_POLICY_IGNORE_ERROR_MODE를 사용합니다.

• GetRequestedRuntimeInfo 함수에 RUNTIME_INFO_IGNORE_ERROR_MODE를 사용합니다.

CLR에서 제공하는 호스트에 대한 UI 정책

CLR은 다양한 시나리오에 대한 호스트 집합을 포함하며, 이러한 호스트는 필요한 버전의 런타임을 로드하는 데 문제가 있을 경우 모두 오류 메시지를 표시합니다. 다음 표에서는 호스트 및 해당 오류 메시지 정책 목록을 제공합니다.

Windows 8 동작 및 UI

CLR 활성화 시스템은 CLR 2.0을 로드하는 데 문제가 있는 점을 제외하고 다른 버전의 Windows 운영 체제에서와 동일한 동작 및 UI를 Windows 8에서 제공합니다. Windows 8에는 CLR 4.5를 사용하는 .NET Framework 4.5가 포함되어 있습니다. 그러나 Windows 8에는 CLR 2.0을 사용하는 .NET Framework 2.0, 3.0 또는 3.5가 포함되어 있지 않습니다. 따라서 CLR 2.0을 사용하는 애플리케이션은 기본적으로 Windows 8에서 실행되지 않습니다. 대신, 사용자가 .NET Framework 3.5를 설치할 수 있는 다음과 같은 대화 상자를 표시합니다. 사용자는 제어판에서 .NET Framework 3.5를 사용하도록 설정할 수도 있습니다. 두 옵션 모두 Windows 11, Windows 10, Windows 8.1, Windows 8에 .NET Framework 3.5 설치 문서에서 설명합니다.

.NET Framework 3.5가 설치되어 있으면 사용자가 해당 Windows 8 컴퓨터에서 .NET Framework 2.0, 3.0 또는 3.5를 사용하는 애플리케이션을 실행할 수 있습니다. 애플리케이션이 .NET Framework 1.0 또는 1.1에서만 실행되도록 명시적으로 구성되지 않은 경우 .NET Framework 1.0 및 1.1 애플리케이션도 실행할 수 있습니다. .NET Framework 1.1에서 마이그레이션을 참조하세요.

.NET Framework 4.5부터 CLR 활성화 로깅이 초기화 오류 메시지가 표시되는 시기 및 이유를 기록하는 로그 항목을 포함하도록 향상되었습니다. 자세한 내용은 방법: CLR 활성화 문제 디버깅을 참조하세요.

참고 항목

• 개발자를 위한 배포 가이드
• 방법: .NET Framework 4 이상 버전을 지원하도록 앱 구성
• 방법: CLR 활성화 문제 디버그
• Windows 11, Windows 10, Windows 8.1, Windows 8에 .NET Framework 3.5 설치