Share via

GetRecoAttributes Function

  • Article

GetRecoAttributes Function

Returns the attributes of the recognizer.

Syntax

[C++]

HRESULT WINAPI GetRecoAttributes(
  HRECOGNIZER hrec,
  RECO_ATTRS *pRecoAttrs
);

Parameters

hrec

[in] Handle to the recognizer.

pRecoAttrs

[in] [out] Attributes of the recognizer. The attributes define the languages and capabilities that the recognizer supports. For more information, see the RECO_ATTRS structure.

Return Value

HRESULT value Description
S_OK Success.
E_INVALIDARG An invalid argument was received.
E_POINTER The parameter is an invalid pointer.
E_FAIL An unspecified error occurred.

Remarks

A Microsoft gesture recognizer should clear the RF_OBJECT bit of the RECO_ATTRS::dwRecoCapabilityFlags and should set every element in the RECO_ATTRS::awLanguageID array to zero.

A gesture recognizer does not normally use a guide. A gesture recognizer with no guide should clear the RF_LINED_INPUT and RF_BOXED_INPUT bits.