Freigeben über


SetContextPropertyValue-Funktion (recapis.h)

Fügt dem Erkennungskontext eine Eigenschaft hinzu.

Wenn eine Eigenschaft bereits vorhanden ist, wird ihr Wert geändert.

Syntax

HRESULT SetContextPropertyValue(
  HRECOCONTEXT hrc,
  GUID         *pGuid,
  ULONG        cbSize,
  BYTE         *pProperty
);

Parameter

hrc

Das Handle für den Erkennungskontext.

pGuid

Die festzulegende Eigenschaft. Geben Sie eine vordefinierte GUID (Globally Unique Identifier) oder anwendungsdefinierte Eigenschaften-GUID an. Eine Liste der vordefinierten Eigenschaften finden Sie unter erkennungseigenschaften-GUIDs.

cbSize

Die Größe des pProperty-Puffers in Bytes.

pProperty

Der Puffer, der den Eigenschaftswert enthält.

Rückgabewert

Diese Funktion kann einen dieser Werte zurückgeben.

Rückgabecode BESCHREIBUNG
S_OK
Erfolg.
E_FAIL
Es ist ein unbekannter Fehler aufgetreten.
E_POINTER
pGUID ist ungültig oder cbSize wurde auf einen sehr großen, ungültigen Wert festgelegt.
TPC_E_INVALID_PROPERTY
pGUID ist ungültig.
E_INVALIDARG
cbSize ist ungültig.
S_FALSE
Wird zurückgegeben, wenn versucht wird, einen Eigenschaftswert festzulegen, wenn er bereits aktiviert wurde.

Hinweise

Die SetContextPropertyValue-Funktion ist optional.

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

GetContextPropertyList-Funktion

GetContextPropertyValue-Funktion