Freigeben über


GetContextPropertyList-Funktion (recapis.h)

Ruft eine Liste von Eigenschaften ab, die von der Erkennung unterstützt werden.

Syntax

HRESULT GetContextPropertyList(
  HRECOCONTEXT hrc,
  ULONG        *pcProperties,
  GUID         *pPropertyGUIDS
);

Parameter

hrc

Das Handle für den Erkennungskontext.

pcProperties

Bei der Eingabe kann die Größe des pPropertyGUIDS-Puffers in Bytes sein. Bei der Ausgabe ist die Größe des pPropertyGUIDS-Puffers in Bytes.

pPropertyGUIDS

Der vom Benutzer zugewiesene Puffer, der eine Liste von Eigenschaften enthält, die von der Erkennung unterstützt werden. Um die Größe des Puffers zu bestimmen, legen Sie pPropertyGUIDS auf NULL fest. verwenden Sie die Größe (pcProperties), um pPropertyGUIDS zuzuweisen. Eine Liste der vordefinierten Eigenschaften finden Sie unter erkennungseigenschaften-GUIDs.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
Erfolg.
E_POINTER
Einer der Parameter ist ein ungültiger Zeiger.
E_FAIL
Es ist ein unbekannter Fehler aufgetreten.
E_INVALIDARG
Es wurde ein ungültiges Argument empfangen.
TPC_E_INSUFFICIENT_BUFFER
Der ppPropertyGUIDS-Puffer ist zu klein.

Hinweise

Diese Funktion ist optional.

Wenn Microsoft-Erkennungsmodule aufgerufen werden, wobei der pcProperties-Parameter auf einen Wert festgelegt ist, der größer als der erforderliche Wert ist, führt dies nicht zu einem Fehler. Stattdessen ändert das Modul die Größe automatisch in den erforderlichen Wert für die Erkennung.

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

Weitere Informationen

GetContextPropertyValue-Funktion

SetContextPropertyValue-Funktion