IHostTaskManager::SetUILocale 메서드

아티클
08/09/2011

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

HRESULT SetUILocale (
    [in] LCID lcid
);

매개 변수

lcid
[in] 새로 지정된 지역 문화권과 언어에 매핑되는 로캘 식별자 값입니다.

반환 값

HRESULT	설명
S_OK	SetUILocale에서 성공적으로 반환되었습니다.
HOST_E_CLRNOTAVAILABLE	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을 반환해야 합니다.