認識エンジンが結果の検索を制限するために使用するファクトロイドを指定します。
入力フィールドに日付が含まれている場合など、入力フィールドが既知の型の場合はファクトロイドを指定します。 インクを初めて処理する前に、この関数を呼び出します。 そのため、Process 関数を呼び出す前に SetFactoid 関数を呼び出します。
構文
HRESULT SetFactoid(
HRECOCONTEXT hrc,
ULONG cwcFactoid,
const WCHAR *pwcFactoid
);
パラメーター
hrc
認識エンジン コンテキストへのハンドル。
cwcFactoid
pwcFactoid の文字数。
pwcFactoid
認識エンジン コンテキストで使用する factoid を識別します。 文字列は NULL で終わるものではありません。
戻り値
この関数は、これらの値のいずれかを返すことができます。
| リターン コード | Description |
|---|---|
|
成功。 |
|
指定された factoid はサポートされていません。 |
|
Process 関数を呼び出す前に、SetFactoid 関数を呼び出す必要があります。 |
|
コンテキストが無効であるか、パラメーターの 1 つが無効なポインターです。 |
|
認識エンジンはこの関数をサポートしていません。 |
|
操作を完了するためにメモリを割り当てることができません。 |
|
指定されていないエラーが発生しました。 |
|
コンテキストに無効な値が含まれています。 |
注釈
cwcFactoid パラメーターで渡すことができるファクトロイドの一覧については、「バージョン 1 でサポートされている Factoid」を参照してください。 このトピックに記載されている DEFAULT factoid は、SetFactoid に渡す有効な値ではありません。タブレット PC プラットフォーム API は、SetFactoid 関数を呼び出す前に DEFAULT を NULL に内部的に変換します。
factoid 文字列の長さを 32768 文字以下に制限することをお勧めします。
Requirements
| Requirement | 価値 |
|---|---|
| サポートされる最小クライアント | Windows XP タブレット PC エディション [デスクトップ アプリ |UWP アプリ] |
| サポートされている最小のサーバー | サポートなし |
| ターゲット プラットフォーム の | ウィンドウズ |
| Header | recapis.h |
| Library | inkobjcore.lib |
| DLL | inkobjcore.dll |