Partilhar via

Função IsStringSupported (recapis.h)

  • Artigo

Retorna um valor que indica se uma palavra, data, hora, número ou outro texto passado está contido no dicionário.

Os resultados desse teste dependem da configuração factoid.

Sintaxe

HRESULT IsStringSupported(
  HRECOCONTEXT hrc,
  ULONG        wcString,
  const WCHAR  *pwcString
);

Parâmetros

hrc

O identificador para o contexto do reconhecedor.

wcString

A contagem, em caracteres Unicode (largos), de pwcString.

pwcString

Os caracteres Unicode (largos) a serem testados.

Retornar valor

Essa função pode retornar um desses valores.

Código de retorno Descrição
S_OK
 Êxito.

Essa função também retornará S_OK se o reconhecedor não der suporte a essa função.
E_OUTOFMEMORY
 Não é possível alocar memória para concluir a operação.
S_FALSE
 Não há suporte para a cadeia de caracteres.
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.

Comentários

Essa função é opcional.

Os resultados desse teste dependem da configuração factoid. Por exemplo, se a configuração factoid estiver definida como padrão, "hello", "555-1234" e "19/10/2002" retornarão S_OK. No entanto, se o factóide estiver definido como TELEPHONE, apenas "555-1234" retornará S_OK, os outros retornarão S_FALSE. Para obter mais informações sobre factóides, consulte Factoids com suporte da versão 1.

Observe que essa função deve levar em consideração todas as informações especificadas em SetTextContext ao retornar um valor. Por exemplo, se o reconhecedor receber chamadas para SetTextContext ("http:", "") e receber um factoid de URL, SetFactoid ((!IS_URL)), IsStringSupported("www.microsoft.com") deverá retornar S_FALSE porque não há "//".

O sinalizador COERCE não tem nenhum efeito em IsStringSupported.

Requisitos

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