MappingRecognizeText 函式 (elscore.h)

發行項
08/23/2023

在 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 值。

備註

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

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

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

MappingRecognizeText 和 MappingDoAction 會嘗試使用傳遞至初始的資料

呼叫 MappingRecognizeText。

需求


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