IInkRecognizers::GetDefaultRecognizer 메서드(msinkaut.h)

NLS(국가 언어 지원) LCID(언어 코드 식별자)로 지정된 알려진 언어에 대한 기본 인식기를 검색합니다.

구문

HRESULT GetDefaultRecognizer(
  [in]          long           lcid,
  [out, retval] IInkRecognizer **DefaultRecognizer
);

매개 변수

[in] lcid

기본 인식기를 검색할 언어의 LCID 로캘 식별자입니다. lcid가 0인 경우 메서드는 사용자의 로캘 설정을 사용하여 검색할 기본 인식기를 결정합니다. 사용자가 국가별 옵션에서 로캘을 지정하지 않은 경우 메서드는 컴퓨터에 대해 지정된 로캘을 사용합니다. 기본값은 0입니다.

[out, retval] DefaultRecognizer

이 메서드가 반환되면 요청된 인식기를 가리키는 포인터가 포함됩니다.

반환 값

이 메서드는 이러한 값 중 하나를 반환할 수 있습니다.

반환 코드	설명
S_OK	성공.
E_POINTER	매개 변수에 잘못된 포인터가 포함되어 있습니다.
E_INK_EXCEPTION	메서드 내에서 예외가 발생했습니다.
E_INVALIDARG	플래그가 잘못되었습니다.
E_UNEXPECTED	예기치 않은 매개 변수 또는 속성 형식입니다.

설명

각 언어에는 기본 인식기가 있을 수 있습니다. 예를 들어 사용자는 미국 영어의 기본 인식기와 프랑스어의 기본 인식기를 가질 수 있습니다. 로캘을 지정하지 않으면 이 메서드는 활성 입력 로캘에 대한 인식기를 반환합니다. 활성 입력 로캘을 선택하려면 ControlPanel의 국가 및 언어 옵션에서 언어 탭에서 세부 정보를 클릭한 다음 기본 입력 언어를 선택합니다.

lcid 매개 변수의 기본값은 0입니다.

이 메서드는 lcid 매개 변수가 알려진 로캘이 아니거나 요청된 로캘에 대해 인식기가 설치되지 않은 경우 오류를 생성합니다.

GetDefaultRecognizer 는 먼저 사용자의 입력 로캘에 일치하는 인식기가 있는지 확인합니다. 없는 경우 현재 시스템 로캘에 일치하는 인식기가 있는지 확인합니다.

NLS에 대한 자세한 내용은 NLS 용어를 참조하세요.

요구 사항

지원되는 최소 클라이언트	Windows XP 태블릿 PC 버전 [데스크톱 앱만 해당]
지원되는 최소 서버	지원되는 버전 없음
대상 플랫폼	Windows
헤더	msinkaut.h
라이브러리	InkObj.dll

추가 정보

IInkRecognizer 인터페이스

IInkRecognizers

InkRecognizers 컬렉션