共用方式為

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
 其中一個參數是無效的指標。
E_FAIL
 發生未指定的錯誤。
E_INVALIDARG
 收到無效的自變數。
E_UNEXPECTED
 非預期的參數或屬性類型。
TPC_E_NOT_RELEVANT
 辨識器內容不包含結果。

規格需求

需求 值
最低支援的用戶端 Windows XP Tablet PC Edition [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 都不支援
目標平台 Windows
標頭 recapis.h
Dll inkobjcore.dll