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 の用語」を参照してください。

必要条件

Requirement	価値
サポートされる最小クライアント	Windows XP タブレット PC エディション [デスクトップアプリのみ]
サポートされている最小のサーバー	サポートなし
ターゲットプラットフォームの	Windows
ヘッダー	msinkaut.h