PFN_MAPPINGCALLBACKPROC コールバック関数 (elscore.h)

[アーティクル]
02/26/2024

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