Partilhar via


Função IsStringSupported (recapis.h)

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 do factóide.

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.

Valor de retorno

Essa função pode retornar um desses valores.

Código de retorno Description
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
Erro não especificado.
E_INVALIDARG
Um argumento inválido foi recebido.

Observações

Essa função é opcional.

Os resultados desse teste dependem da configuração do factóide. Por exemplo, se a configuração de factoid estiver definida como padrão, "olá", "555-1234" e "19/10/2002" retornarão S_OK. No entanto, se o factóide estiver definido como TELEPHONE, somente "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)) então IsStringSupported("www.microsoft.com") deverá retornar S_FALSE porque está faltando o "//".

O sinalizador COERCE não tem efeito sobre IsStringSupported.

Requirements

Requirement Value
Cliente mínimo suportado Windows XP Tablet PC Edition [aplicativos da área de trabalho | Aplicativos UWP]
Servidor mínimo compatível Nenhum compatível
da Plataforma de Destino Windows
Header recapis.h
Library inkobjcore.lib
de DLL inkobjcore.dll