MAPPING_OPTIONS 구조체(elscore.h)

텍스트 인식 옵션을 포함합니다. 이 구조에 저장된 값은 MappingRecognizeText의 동작 및 결과에 영향을 줍니다.

구문

typedef struct _MAPPING_OPTIONS {
  size_t                  Size;
  LPWSTR                  pszInputLanguage;
  LPWSTR                  pszOutputLanguage;
  LPWSTR                  pszInputScript;
  LPWSTR                  pszOutputScript;
  LPWSTR                  pszInputContentType;
  LPWSTR                  pszOutputContentType;
  LPWSTR                  pszUILanguage;
  PFN_MAPPINGCALLBACKPROC pfnRecognizeCallback;
  LPVOID                  pRecognizeCallerData;
  DWORD                   dwRecognizeCallerDataSize;
  PFN_MAPPINGCALLBACKPROC pfnActionCallback;
  LPVOID                  pActionCallerData;
  DWORD                   dwActionCallerDataSize;
  DWORD                   dwServiceFlag;
  unsigned                GetActionDisplayName : 1;
} MAPPING_OPTIONS, *PMAPPING_OPTIONS;

멤버

Size

구조체 버전의 유효성을 검사하는 데 사용되는 구조체의 크기입니다. 이 값은 필수입니다.

pszInputLanguage

선택 사항입니다. 서비스에서 허용할 수 있어야 하는 입력 언어를 식별하는 IETF 명명 규칙에 따라 입력 언어 문자열에 대한 포인터입니다. 애플리케이션은 이 멤버를 NULL 로 설정하여 서비스에서 지원하는 입력 언어로 입력을 자유롭게 해석할 수 있음을 나타낼 수 있습니다.

pszOutputLanguage

선택 사항입니다. 서비스가 결과를 생성하는 데 사용할 수 있어야 하는 출력 언어를 식별하는 IETF 명명 규칙에 따라 출력 언어 문자열에 대한 포인터입니다. 서비스에서 출력 언어를 결정해야 하는 경우 애플리케이션에서 이 멤버를 NULL 로 설정할 수 있습니다.

pszInputScript

선택 사항입니다. 서비스에서 수락해야 하는 표준 유니코드 스크립트 이름에 대한 포인터입니다. 애플리케이션은 서비스가 입력을 처리하는 방법을 결정할 수 있도록 이 멤버를 NULL 로 설정할 수 있습니다.

pszOutputScript

선택 사항입니다. 서비스에서 결과를 검색하는 데 사용해야 하는 표준 유니코드 스크립트 이름에 대한 포인터입니다. 애플리케이션은 서비스가 출력 스크립트를 결정할 수 있도록 이 멤버를 NULL 로 설정할 수 있습니다.

pszInputContentType

선택 사항입니다. 애플리케이션이 데이터를 통과할 때 서비스에서 해석할 수 있어야 하는 형식을 식별하는 MIME 콘텐츠 형식의 형식에 따라 문자열에 대한 포인터입니다. 콘텐츠 형식의 예로는 "text/plain", "text/html" 및 "text/css"가 있습니다. 애플리케이션은 이 멤버를 NULL 로 설정하여 "text/plain" 콘텐츠 형식을 나타낼 수 있습니다.

참고 Windows 7에서 ELS 서비스는 콘텐츠 형식 "text/plain"만 지원합니다. 콘텐츠 형식 사양은 텍스트 미디어 형식에서 찾을 수 있습니다.

 

pszOutputContentType

선택 사항입니다. 서비스에서 데이터를 검색해야 하는 형식을 식별하는 MIME 콘텐츠 형식의 형식에 따라 문자열에 대한 포인터입니다. 애플리케이션은 서비스가 출력 콘텐츠 형식을 결정할 수 있도록 이 멤버를 NULL 로 설정할 수 있습니다.

pszUILanguage

예약되어 있습니다.

pfnRecognizeCallback

선택 사항입니다. MappingRecognizeText 함수의 결과를 사용하여 콜백을 수신하는 애플리케이션 콜백 함수에 대한 포인터입니다. 콜백 함수를 지정하면 텍스트 인식이 비동기 모드로 실행되고 애플리케이션은 콜백 함수를 통해 결과를 가져옵니다. 텍스트 인식이 동기적이면 애플리케이션에서 이 멤버를 NULL 로 설정해야 합니다.

pRecognizeCallerData

선택 사항입니다. 텍스트 인식이 완료된 후 서비스에서 콜백 함수에 전달된 프라이빗 애플리케이션 데이터에 대한 포인터입니다. 애플리케이션은 프라이빗 애플리케이션 데이터를 나타내기 위해 이 멤버를 NULL 로 설정해야 합니다.

dwRecognizeCallerDataSize

선택 사항입니다. pRecognizeCallerData 멤버가 나타내는 모든 프라이빗 애플리케이션 데이터의 크기(바이트)입니다.

pfnActionCallback

예약되어 있습니다.

pActionCallerData

예약되어 있습니다.

dwActionCallerDataSize

예약되어 있습니다.

dwServiceFlag

선택 사항입니다. 서비스 공급자가 서비스 동작에 영향을 미치기 위해 정의하는 프라이빗 플래그입니다. 서비스는 필요에 따라 이 플래그를 해석할 수 있습니다.

참고 Windows 7의 경우 사용 가능한 ELS 서비스가 플래그를 지원하지 않습니다.

 

GetActionDisplayName

예약되어 있습니다.

설명

서비스에서 NULL 멤버를 기본값으로 처리하므로 애플리케이션이 이 구조의 모든 멤버를 채울 필요는 없습니다. 사용되지 않는 모든 멤버는 0으로 설정해야 합니다.

경고 이 구조체에서 MappingRecognizeText에 전달된 데이터와 해당 호출의 pszText 인수에서 참조하는 데이터

pBag에서 전달된 속성 모음 구조가 를 통해 해제될 때까지 유효한 상태를 유지해야 합니다.

MappingFreePropertyBag. 동기 및 비동기 모두 에 대한 호출이기 때문입니다.

MappingRecognizeText 및 MappingDoAction 은 초기 에 전달된 데이터를 사용하려고 시도합니다.

MappingRecognizeText를 호출합니다.

 

요구 사항

지원되는 최소 클라이언트	Windows 7 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버	Windows Server 2008 R2 [데스크톱 앱 | UWP 앱]
머리글	elscore.h

추가 정보

확장된 언어 서비스 구조

MAPPING_DATA_RANGE

MappingRecognizeText