GetPreferredPacketDescription-Funktion (recapis.h)
Ruft eine Paketbeschreibung ab, die die von der Erkennung verwendeten Paketeigenschaften enthält.
Syntax
HRESULT GetPreferredPacketDescription(
HRECOGNIZER hrec,
PACKET_DESCRIPTION *pPacketDescription
);
Parameter
hrec
Handle an die Erkennung.
pPacketDescription
Beschreibt den Inhalt der Pakete, die die Erkennung verwendet. Weitere Informationen finden Sie in der PACKET_DESCRIPTION-Struktur .
Um die Paketbeschreibung abzurufen, initialisieren Sie die Paketbeschreibung mit Nullen, und rufen Sie die GetPreferredPacketDescription-Funktion auf . Die Funktion füllt die Anzahl der Eigenschaften und Schaltflächen auf, die Sie verwenden, um Platz für die Elemente pPacketProperties und pguidButtons der PACKET_DESCRIPTION-Struktur zuzuweisen. Rufen Sie die Funktion erneut auf, um den Rest der Paketbeschreibung aufzufüllen.
Der pguidButtons-Member der PACKET_DESCRIPTION-Struktur kann null sein, wenn GetPreferredPacketDescription zurückgegeben wird. Dies bedeutet, dass die Pakete keine Schaltflächendaten enthalten, sodass diesem Member keine pguidButtons zugeordnet sind. In diesem Fall sollte die aufrufende Funktion den Zeiger NULL belassen.
Rückgabewert
Diese Funktion kann einen dieser Werte zurückgeben.
| Rückgabecode | BESCHREIBUNG |
|---|---|
|
Erfolg. |
|
Der Parameter ist ein ungültiger Zeiger. |
|
Der pPacketDescription-Puffer ist zu klein. |
|
Es ist ein unbekannter Fehler aufgetreten. |
|
Ein ungültiges Argument wurde empfangen. |
Hinweise
In der Regel verwenden Erkennungen die Koordinateneigenschaften (x, y) und ignorieren die anderen. Wenn Sie die Freihandeingabe zur späteren Erkennung in einer Datei speichern, verwenden Sie die bevorzugte Paketbeschreibung, um nur die Eigenschaften zu speichern, die von der Erkennung verwendet werden.
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Windows XP Tablet PC Edition [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Nicht unterstützt |
| Zielplattform | Windows |
| Kopfzeile | recapis.h |
| DLL | inkobjcore.dll |