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