Compartilhar via


Função SetContextPropertyValue (recapis.h)

Adiciona uma propriedade ao contexto do reconhecedor.

Se uma propriedade já existir, seu valor será modificado.

Sintaxe

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

Parâmetros

hrc

O identificador para o contexto do reconhecedor.

pGuid

A propriedade a ser definida. Especifique uma propriedade predefinida guid (identificador global exclusivo) ou GUID de propriedade definida pelo aplicativo. Para obter uma lista de propriedades predefinidas, consulte os GUIDs de propriedade de reconhecimento.

cbSize

O tamanho, em bytes, do buffer pProperty .

pProperty

O buffer que contém o valor da propriedade.

Retornar valor

Essa função pode retornar um desses valores.

Código de retorno Descrição
S_OK
Êxito.
E_FAIL
Ocorreu um erro não especificado.
E_POINTER
pGUID é inválido ou cbSize foi definido como um valor muito grande e inválido.
TPC_E_INVALID_PROPERTY
pGUID é inválido.
E_INVALIDARG
cbSize é inválido.
S_FALSE
Retornado quando é feita uma tentativa de definir um valor de propriedade quando ele já tiver sido habilitado.

Comentários

A função SetContextPropertyValue é opcional.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP Tablet PC Edition [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Nenhum compatível
Plataforma de Destino Windows
Cabeçalho recapis.h
DLL inkobjcore.dll

Confira também

Função GetContextPropertyList

Função GetContextPropertyValue