共用方式為


MappingRecognizeText 函式 (elscore.h)

在 ELS 服務上呼叫 以辨識文字。 例如,Microsoft 語言偵測服務會嘗試辨識寫入輸入文字的語言。

語法

HRESULT MappingRecognizeText(
  [in]           PMAPPING_SERVICE_INFO pServiceInfo,
  [in]           LPCWSTR               pszText,
  [in]           DWORD                 dwLength,
  [in]           DWORD                 dwIndex,
  [in, optional] PMAPPING_OPTIONS      pOptions,
  [in, out]      PMAPPING_PROPERTY_BAG pbag
);

參數

[in] pServiceInfo

包含要用於文字辨識之服務相關資訊 的MAPPING_SERVICE_INFO 結構的指標。 結構必須是先前呼叫 MappingGetServices所擷取的其中一個結構。 此參數無法設定為 Null

[in] pszText

要辨識之文字的指標。 文字必須是 UTF-16,但某些服務對於輸入格式有額外的需求。 此參數無法設定為 Null

[in] dwLength

pszText中所指定文字的長度,以字元為單位。

[in] dwIndex

服務所使用之指定文字內的索引。 此值應該介於 0 和 dwLength-1之間。 如果應用程式想要處理整個文字,它應該將此參數設定為 0。

[in, optional] pOptions

MAPPING_OPTIONS結構的指標,其中包含影響文字辨識結果和行為的選項。 應用程式不需要指定所有結構成員的值。 此參數可以設定為 Null ,以使用預設對應選項。

[in, out] pbag

服務在其中儲存其結果 之MAPPING_PROPERTY_BAG 結構的指標。 在輸入時,應用程式會傳遞結構,只提供大小,而其他成員則設定為 0。 在輸出中,結構會在文字辨識期間填入服務所產生的資訊。 此參數無法設定為 Null

傳回值

如果成功,則傳回S_OK。 如果失敗,函式會傳回錯誤 HRESULT 值。

備註

要辨識的文字類型取決於應用程式所使用的服務類型。 如需詳細資訊,請參閱 要求文字辨識

警告pszTextpOptions所參考的資料必須維持有效狀態,直到pBag傳遞的屬性包結構透過 釋放

MappingFreePropertyBag。 這是因為 對 的同步和非同步呼叫

MappingRecognizeTextMappingDoAction 會嘗試使用傳遞至初始的資料

呼叫 MappingRecognizeText

 

需求

   
最低支援的用戶端 Windows 7 [傳統型應用程式 |UWP 應用程式]
最低支援的伺服器 Windows Server 2008 R2 [傳統型應用程式 |UWP 應用程式]
目標平台 Windows
標頭 elscore.h
程式庫 Elscore.lib
Dll Elscore.dll

另請參閱

擴充語言服務

擴充語言服務函式

MAPPING_OPTIONS

MAPPING_PROPERTY_BAG

MAPPING_SERVICE_INFO

要求文字辨識