Share via


SetContextPropertyValue Function

SetContextPropertyValue Function

Adds a property to the recognizer context.

If a property already exists, its value is modified.

Syntax

[C++]

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

Parameters

hrc

[in] Handle to the recognizer context.

pGUID

[in] Identifies the property to set. Specify a predefined property globally unique identifier (GUID) or application-defined property GUID. For a list of predefined properties, see the recognition Property GUIDs.

cbSize

[in] Size, in bytes, of the pProperty buffer.

pProperty

[in] Buffer that contains the property value.

Return Value

HRESULT value Description
S_OK Success.
E_POINTER pGuid is invalid or cbSize has been set to a very large, invalid value.
TPC_E_INVALID_PROPERTY pGuid is invalid.
E_INVALIDARG cbSize is invalid.

Remarks

The SetContextPropertyValue function is optional.