GetContextPropertyValue-Funktion (recapis.h)
Gibt einen angegebenen Eigenschaftswert aus dem Erkennungskontext zurück.
HRESULT GetContextPropertyValue(
HRECOCONTEXT hrc,
GUID *pGuid,
ULONG *pcbSize,
BYTE *pProperty
);
hrc
Das Handle für den Erkennungskontext.
pGuid
Die abzurufende Eigenschaft. Geben Sie eine vordefinierte GuiD (Globally Unique Identifier) oder eine anwendungsdefinierte GUID an. Eine Liste der vordefinierten Eigenschaften finden Sie unter erkennungseigenschaften-GUIDs.
pcbSize
Bei der Eingabe kann die Größe des pProperty-Puffers in Bytes sein. Bei der Ausgabe ist die Größe des pProperty-Puffers in Bytes.
pProperty
Der vom Benutzer zugewiesene Puffer, um den Eigenschaftswert zu enthalten. Um die Größe des Puffers zu bestimmen, legen Sie pProperty auf NULL fest. verwenden Sie die Größe, um pProperty zuzuweisen.
Diese Funktion kann einen dieser Werte zurückgeben.
Rückgabecode | BESCHREIBUNG |
---|---|
|
Erfolg. |
|
Einer der Parameter ist ein ungültiger Zeiger. |
|
Es ist ein unbekannter Fehler aufgetreten. |
|
Es wurde ein ungültiges Argument empfangen. |
|
Die Eigenschaft wurde nicht vom Kontext festgelegt. Dies kann vorkommen, wenn die Eigenschaft nur unter bestimmten Umständen festgelegt wird oder wenn die Eigenschaft erst nach einem noch nicht aufgetretenen Ereignis festgelegt werden soll. |
|
Die Erkennung unterstützt die -Eigenschaft nicht. |
|
Der pProperty-Puffer ist zu klein. |
Diese Funktion ist optional.
Sie können die GetContextPropertyValue-Funktion verwenden, um Informationen abzurufen, die die Erkennung an den Aufrufer zurückgibt. Dadurch kann eine benutzerdefinierte Erkennung über Modi und Einstellungen verfügen und Daten zurückgeben, die für diese Erkennung eindeutig sind.
In den Microsoft-Erkennungsfunktionen führt das Aufrufen der GetContextPropertyValue-Funktion mit festgelegtem pcbSize-Parameter auf einen Wert, der größer als erforderlich ist, nicht zu einem falschen Rückgabewert. Stattdessen ändert der Code die Größe automatisch in den erforderlichen Wert für die aktuelle GUID.
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 |