다음을 통해 공유

IHostTaskManager::SetUILocale 메서드

  • 아티클

CLR(공용 언어 런타임)이 현재 실행 중인 작업에서 UI(사용자 인터페이스) 로캘 또는 문화권을 변경했음을 호스트에 알립니다.

구문

HRESULT SetUILocale (  
    [in] LCID lcid  
);

매개 변수

lcid
[in] 새로 할당된 지리적 문화권 및 언어에 매핑되는 로캘 식별자 값입니다.

Return Value

HRESULT 설명
S_OK SetUILocale가 성공적으로 반환되었습니다.
HOST_E_CLRNOTAVAILABLE CLR이 프로세스에 로드되지 않았거나 CLR이 관리 코드를 실행하거나 호출을 성공적으로 처리할 수 없는 상태입니다.
HOST_E_TIMEOUT 호출 시간이 초과되었습니다.
HOST_E_NOT_OWNER 호출자는 잠금을 소유하지 않습니다.
HOST_E_ABANDONED 차단된 스레드 또는 파이버가 이벤트를 기다리는 동안 이벤트가 취소되었습니다.
E_FAIL 알 수 없는 치명적인 오류가 발생했습니다. 메서드가 E_FAIL을 반환하면 CLR은 더 이상 프로세스 내에서 사용할 수 없습니다. 호스팅 메서드에 대한 후속 호출은 HOST_E_CLRNOTAVAILABLE을 반환합니다.
E_NOTIMPL 호스트는 관리되는 사용자 코드가 UI 문화권을 변경하는 것을 허용하지 않습니다.

설명

런타임은 Thread.CurrentUICulture 속성 값이 관리 코드에 의해 변경될 때 SetUILocale을 호출합니다. 이 메서드는 호스트가 로캘 동기화를 위해 가질 수 있는 모든 메커니즘을 실행할 수 있는 기회를 제공합니다. 호스트가 관리 코드에서 UI 로캘을 변경하는 것을 허용하지 않거나 로캘을 동기화하는 메커니즘을 구현하지 않는 경우 이 메서드에서 E_NOTIMPL을 반환해야 합니다.

요구 사항

플랫폼:시스템 요구 사항을 참조하세요.

헤더: MSCorEE.h

라이브러리: 리소스로 MSCorEE.dll에 포함됩니다.

.NET Framework 버전: 2.0부터 사용 가능

참고 항목