Compartilhar via


Função GetContextPropertyList (recapis.h)

Recupera uma lista de propriedades compatíveis com o reconhecedor.

Sintaxe

HRESULT GetContextPropertyList(
  HRECOCONTEXT hrc,
  ULONG        *pcProperties,
  GUID         *pPropertyGUIDS
);

Parâmetros

hrc

O identificador para o contexto do reconhecedor.

pcProperties

Na entrada, o tamanho, em bytes, o buffer pPropertyGUIDS pode ser. Na saída, o tamanho, em bytes, é o buffer pPropertyGUIDS .

pPropertyGUIDS

O buffer alocado pelo usuário para conter uma lista de propriedades compatíveis com o reconhecedor. Para determinar o tamanho do buffer, defina pPropertyGUIDS como NULL; use o tamanho (pcProperties) para alocar pPropertyGUIDS. Para obter uma lista de propriedades predefinidas, consulte os GUIDs de propriedade de reconhecimento.

Retornar valor

Essa função pode retornar um desses valores.

Código de retorno Descrição
S_OK
Êxito.
E_POINTER
Um dos parâmetros é um ponteiro inválido.
E_FAIL
Ocorreu um erro não especificado.
E_INVALIDARG
Um argumento inválido foi recebido.
TPC_E_INSUFFICIENT_BUFFER
O buffer ppPropertyGUIDS é muito pequeno.

Comentários

Essa função é opcional.

Quando os mecanismos de reconhecimento da Microsoft são chamados com o parâmetro pcProperties definido como um valor maior que o valor necessário, isso não resulta em um erro. Em vez disso, o mecanismo altera automaticamente o tamanho para o valor necessário para o reconhecedor.

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 GetContextPropertyValue

Função SetContextPropertyValue