GetBestResultString 関数 (recapis.h)

  • [アーティクル]

最適な結果文字列を取得します。

構文

HRESULT GetBestResultString(
  HRECOCONTEXT hrc,
  ULONG        *pcSize,
  WCHAR        *pwcBestResult
);

パラメーター

hrc

認識エンジン コンテキストを処理します。

pcSize

入力時に、 pwcBestResult バッファーが保持できる文字数。 出力時に、 pwcBestResult バッファーに含まれる文字数。 pwcBestResult が NULL の場合、この関数は pwcBestResult バッファーの割り当てに使用するバッファーの必要なサイズを返します。

pwcBestResult

認識結果。 バッファーが小さすぎる場合、関数は文字列を切り捨てます。 文字列は NULL で終わるものではありません。 バッファーの必要なサイズを確認するには、 pwcBestResult を NULL に設定します。 pcSize を使用して pwcBestResult バッファーを割り当てます。

戻り値

この関数は、これらの値のいずれかを返すことができます。

リターン コード 説明
S_OK
 正常終了しました。

ラテンおよび東アジアの認識エンジンの場合、 pwcBestResult の空の文字列と組み合わせることで、認識結果が存在しないことを意味します。
TPC_S_TRUNCATED
 この文字列は、 pwcBestResult バッファーに収まるように切り捨てられます。
E_POINTER
 パラメーターの 1 つが無効なポインターです。
E_FAIL
 未指定のエラーが発生しました。
E_INVALIDARG
 無効な引数が受け取られました。
E_UNEXPECTED
 予期しないパラメーターまたはプロパティの種類。
TPC_E_NOT_RELEVANT
 認識エンジン コンテキストに結果が含まれていません。

要件

要件 値
サポートされている最小のクライアント Windows XP タブレット PC エディション [デスクトップ アプリ |UWP アプリ]
サポートされている最小のサーバー サポートなし
対象プラットフォーム Windows
ヘッダー recapis.h
[DLL] inkobjcore.dll