MAPPING_OPTIONS Struktur (elscore.h)

Enthält Optionen für die Texterkennung. Die in dieser Struktur gespeicherten Werte wirken sich auf das Verhalten und die Ergebnisse von MappingRecognizeText aus.

Syntax

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;

Member

Size

Größe der Struktur, die zum Überprüfen der Strukturversion verwendet wird. Dieser Wert ist erforderlich.

pszInputLanguage

Optional. Zeiger auf eine Eingabesprachenzeichenfolge gemäß der IETF-Benennungskonvention, die die Eingabesprache identifiziert, die der Dienst akzeptieren kann. Die Anwendung kann diesen Member auf NULL festlegen, um anzugeben, dass der Dienst die Eingabe als jede von ihr unterstützte Eingabesprache interpretieren kann.

pszOutputLanguage

Optional. Zeiger auf eine Ausgabesprachenzeichenfolge gemäß der IETF-Benennungskonvention, die die Ausgabesprache identifiziert, die der Dienst verwenden soll, um Ergebnisse zu erzeugen. Die Anwendung kann diesen Member auf NULL festlegen, wenn der Dienst die Ausgabesprache festlegen soll.

pszInputScript

Optional. Zeiger auf einen Unicode-Standardskriptnamen, der vom Dienst akzeptiert werden sollte. Die Anwendung kann diesen Member auf NULL festlegen, damit der Dienst entscheiden kann, wie die Eingabe behandelt wird.

pszOutputScript

Optional. Zeiger auf einen Unicode-Standardskriptnamen, den der Dienst zum Abrufen von Ergebnissen verwenden sollte. Die Anwendung kann diesen Member auf NULL festlegen, damit der Dienst das Ausgabeskript entscheiden kann.

pszInputContentType

Optional. Zeiger auf eine Zeichenfolge, die dem Format der MIME-Inhaltstypen folgt, die das Format identifiziert, das der Dienst interpretieren kann, wenn die Anwendung Daten übergibt. Beispiele für Inhaltstypen sind "text/plain", "text/html" und "text/css". Die Anwendung kann diesen Member auf NULL festlegen, um den Inhaltstyp "text/plain" anzugeben.

Hinweis In Windows 7 unterstützen die ELS-Dienste nur den Inhaltstyp "text/plain". Eine Inhaltstypspezifikation finden Sie unter Textmedientypen.

 

pszOutputContentType

Optional. Zeiger auf eine Zeichenfolge, die dem Format der MIME-Inhaltstypen folgt, die das Format angibt, in dem der Dienst Daten abrufen soll. Die Anwendung kann diesen Member auf NULL festlegen, damit der Dienst den Ausgabeinhaltstyp bestimmen kann.

pszUILanguage

Reserviert.

pfnRecognizeCallback

Optional. Zeiger auf eine Anwendungsrückruffunktion, um Rückrufe mit den Ergebnissen der MappingRecognizeText-Funktion zu empfangen. Wenn eine Rückruffunktion angegeben wird, wird die Texterkennung im asynchronen Modus ausgeführt, und die Anwendung erhält Ergebnisse über die Rückruffunktion. Die Anwendung muss diesen Member auf NULL festlegen, wenn die Texterkennung synchron sein soll.

pRecognizeCallerData

Optional. Zeiger auf private Anwendungsdaten, die von einem Dienst an die Rückruffunktion übergeben werden, nachdem die Texterkennung abgeschlossen ist. Die Anwendung muss diesen Member auf NULL festlegen, um keine privaten Anwendungsdaten anzugeben.

dwRecognizeCallerDataSize

Optional. Größe aller privaten Anwendungsdaten, die vom pRecognizeCallerData-Member angegeben werden, in Bytes.

pfnActionCallback

Reserviert.

pActionCallerData

Reserviert.

dwActionCallerDataSize

Reserviert.

dwServiceFlag

Optional. Privates Flag, das ein Dienstanbieter definiert, um das Dienstverhalten zu beeinflussen. Dienste können dieses Flag nach Bedarf interpretieren.

Hinweis Für Windows 7 unterstützt keiner der verfügbaren ELS-Dienste Flags.

 

GetActionDisplayName

Reserviert.

Hinweise

Die Anwendung muss nicht alle Member dieser Struktur ausfüllen, da Dienste NULL-Member als Standardwerte behandeln. Alle nicht verwendeten Member müssen auf 0 festgelegt werden.

Warnung Die Daten, die in dieser Struktur an MappingRecognizeText übergeben werden, sowie die Daten, auf die das argument pszText in diesem Aufruf verweist,

muss gültig bleiben, bis die von pBag übergebene Eigenschaftsbeutelstruktur über freigegeben wird

MappingFreePropertyBag. Dies liegt daran, dass sowohl synchrone als auch asynchrone Aufrufe von

MappingRecognizeText und MappingDoAction versuchen, die an den Ersten übergebenen Daten zu verwenden.

Rufen Sie MappingRecognizeText auf.

 

Anforderungen

Unterstützte Mindestversion (Client)	Windows 7 [Desktop-Apps | UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [Desktop-Apps | UWP-Apps]
Kopfzeile	elscore.h

Weitere Informationen

Erweiterte Strukturen für linguistische Dienste

MAPPING_DATA_RANGE

MappingRecognizeText