PFN_MAPPINGCALLBACKPROC コールバック関数 (elscore.h)
MappingRecognizeText 関数によって生成されたデータを非同期的に処理するアプリケーション定義のコールバック関数。 MAPPINGCALLBACKPROC 型は、このコールバック関数へのポインターを定義します。 MappingCallbackProc は、アプリケーション定義関数名のプレースホルダーです。
構文
PFN_MAPPINGCALLBACKPROC PfnMappingcallbackproc;
void PfnMappingcallbackproc(
[in] _MAPPING_PROPERTY_BAG *pBag,
[in] LPVOID data,
[in] DWORD dwDataSize,
[in] HRESULT Result
)
{...}
パラメーター
[in] pBag
MappingRecognizeText の呼び出しの結果を含むMAPPING_PROPERTY_BAG構造体へのポインター。
[in] data
プライベート アプリケーション データへのポインター。 このポインターは、MAPPING_OPTIONS構造体の pRecognizeCallerData メンバーで渡されたポインターと同じです。
[in] dwDataSize
プライベート アプリケーション データのサイズ (バイト単位)。 このサイズは、アプリケーションが MappingRecognizeText を非同期的に呼び出すときに 、MAPPING_OPTIONS 構造体の dwRecognizeCallerDataSize メンバーに 渡されるサイズと同じです。
[in] Result
MappingRecognizeText からコードを返します。 戻りコードは、関数が成功した場合はS_OK。それ以外の場合はエラー コードです。
戻り値
なし
解説
MappingCallbackProc 関数は、MappingRecognizeText によって取得された結果を使用します。 アプリケーションは、MAPPING_OPTIONS構造体で MappingRecognizeText にアドレスを渡すことによってコールバック関数を登録します。
アプリケーションでは、pBag パラメーターのデータを使用する前に Result パラメーターをチェックする必要があります。 プロパティ バッグのデータを使用して行う場合、アプリケーションは MappingFreePropertyBag を呼び出す必要があります。これは、プロパティ バッグに元のテキストへのポインターを含めることができるためです。 プロパティ バッグの詳細については、 MAPPING_PROPERTY_BAG 構造の解説を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 7 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2008 R2 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | elscore.h |