Método IFilter::GetValue (filter.h)

  • Artigo

Observação

O Serviço de Indexação não tem mais suporte a partir do Windows XP e não está disponível para uso a partir do Windows 8. Em vez disso, use a pesquisa do lado do cliente da Pesquisa do Windows e o Microsoft Search Server Express para pesquisa no lado do servidor.

Recupera um valor (propriedade de tipo de valor interno) de uma parte, que deve ter um valor de enumeração CHUNKSTATE de CHUNK_VALUE.

Sintaxe

SCODE GetValue(
  [out] PROPVARIANT **ppPropValue
);

Parâmetros

[out] ppPropValue

Um ponteiro para uma variável de saída que recebe um ponteiro para a estrutura PROPVARIANT que contém a propriedade value-type.

Valor retornado

Esse método pode retornar um desses valores.

Código de retorno Descrição
S_OK
 A operação foi concluída com êxito.
FILTER_E_NO_MORE_VALUES
O método GetValue já foi chamado nesta parte; esse valor deve ser retornado até que o método IFilter::GetChunk tenha sido chamado com êxito e tenha avançado para a próxima parte.
FILTER_E_NO_VALUES
 A parte atual não tem um valor de enumeração CHUNKSTATE de CHUNK_VALUE.

Comentários

Chame o método GetValue apenas uma vez por parte.

Observe que o efeito de produzir o mesmo valor de mais de uma parte é indefinido. Somente a última configuração do valor é válida.

Anotações para chamadores

Aloque a estrutura PROPVARIANT com CoTaskMemAlloc. Algumas estruturas PROPVARIANT contêm ponteiros, que podem ser liberados chamando a função PropVariantClear . Cabe ao chamador do método GetValue chamar PropVariantClear.

Requisitos

   
Cliente mínimo com suporte Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows 2000 Server [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho filter.h

Confira também

Ifilter