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

選擇性。 服務應接受的標準 Unicode 腳本名稱指標。 應用程式可以將此成員設定為 Null ，讓服務決定如何處理輸入。

pszOutputScript

選擇性。 服務應該用來擷取結果的標準 Unicode 腳本名稱指標。 應用程式可以將這個成員設定為 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