MappingDoAction 函式 (elscore.h)
導致 ELS 服務在文字辨識發生之後執行動作。 例如,電話撥號程式服務必須先辨識電話號碼,然後可以執行撥打號碼的「動作」。
語法
HRESULT MappingDoAction(
[in, out] PMAPPING_PROPERTY_BAG pBag,
[in] DWORD dwRangeIndex,
[in] LPCWSTR pszActionId
);
參數
[in, out] pBag
MAPPING_PROPERTY_BAG結構的指標,其中包含先前呼叫MappingRecognizeText的結果。 此參數無法設定為 Null。
[in] dwRangeIndex
已辨識文字範圍文字範圍文字辨識結果內的起始索引。 此值應介於 0 與範圍計數之間。
[in] pszActionId
要執行的動作識別碼指標。 此參數無法設定為 Null。
傳回值
如果成功,則傳回S_OK。 如果函式失敗,函式會傳回錯誤 HRESULT 值。
備註
應用程式必須在 對 MappingDoAction 的呼叫前面加上 MappingRecognizeText的呼叫。
警告傳遞至MappingRecognizeText的pszText和pOptions引數所參考的資料
必須維持有效狀態,直到 pBag 傳遞的屬性包結構透過 釋放為止
MappingFreePropertyBag。 這是因為 同步和非同步呼叫
MappingRecognizeText 和 MappingDoAction 會嘗試使用傳遞至初始的資料
呼叫 MappingRecognizeText。
需求
最低支援的用戶端 | Windows 7 [僅限傳統型應用程式] |
最低支援的伺服器 | Windows Server 2008 R2 [僅限傳統型應用程式] |
目標平台 | Windows |
標頭 | elscore.h |
程式庫 | Elscore.lib |
Dll | Elscore.dll |