Compartilhar via


Método IQueryParser::P arse (structuredquery.h)

Analisa uma cadeia de caracteres de entrada que contém palavras-chave e/ou conteúdo de Consulta Estruturada para produzir um objeto IQuerySolution .

Sintaxe

HRESULT Parse(
  [in]          LPCWSTR        pszInputString,
  [in]          IEnumUnknown   *pCustomProperties,
  [out, retval] IQuerySolution **ppSolution
);

Parâmetros

[in] pszInputString

Tipo: LPCWSTR

Um ponteiro para a cadeia de caracteres de entrada Unicode a ser analisada.

[in] pCustomProperties

Tipo: IEnumUnknown*

Uma enumeração de objetos IRichChunk , uma para cada propriedade personalizada que o aplicativo reconheceu. Esse parâmetro pode ser NULL, que é equivalente a uma enumeração vazia.

[out, retval] ppSolution

Tipo: IQuerySolution**

Recebe um objeto IQuerySolution . O chamador deve liberá-lo chamando seu método IUnknown::Release .

Retornar valor

Tipo: HRESULT

Se o método for bem-sucedido, ele retornará S_OK. Caso contrário, ele retornará um código de erro HRESULT.

Comentários

Para cada objeto IRichChunk , as informações de posição identificam o intervalo de caracteres da propriedade personalizada, o valor da cadeia de caracteres é o nome de uma propriedade real e o PROPVARIANT não é usado. Embora qualquer propriedade possa ser usada, essas propriedades genéricas são incluídas especificamente para essa finalidade:

  • System.StructuredQuery.CustomProperty.Boolean
  • System.StructuredQuery.CustomProperty.DateTime
  • System.StructuredQuery.CustomProperty.Integer
  • System.StructuredQuery.CustomProperty.FloatingPoint
  • System.StructuredQuery.CustomProperty.String
Um aplicativo pode usá-los na enumeração passada no parâmetro pCustomProperties e procurá-los na árvore de condição resultante.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP com SP2, Windows Vista [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2003 com SP1 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho structuredquery.h
Redistribuível Pesquisa da Área de Trabalho do Windows (WDS) 3.0