Windows apps
Collapse the table of content
Expand the table of content
The topic you requested is included in another documentation set. For convenience, it's displayed below. Choose Switch to see the topic in its original location.

IFilter::GetValue method

[Indexing Service is no longer supported as of Windows XP and is unavailable for use as of Windows 8. Instead, use Windows Search for client side search and Microsoft Search Server Express for server side search.]

Retrieves a value (internal value-type property) from a chunk, which must have a CHUNKSTATE enumeration value of CHUNK_VALUE.


  [out] PROPVARIANT **ppPropValue


ppPropValue [out]

A pointer to an output variable that receives a pointer to the PROPVARIANT structure that contains the value-type property.

Return value

This method can return one of these values.

Return codeDescription

The operation was completed successfully.


The GetValue method has already been called on this chunk; this value should be returned until the IFilter::GetChunk method has been called successfully and has advanced to the next chunk.


The current chunk does not have a CHUNKSTATE enumeration value of CHUNK_VALUE.



Call the GetValue method only once per chunk.

Note that the effect of producing the same value from more than one chunk is undefined. Only the last setting of the value is valid.

Notes to Callers

Allocate the PROPVARIANT structure with CoTaskMemAlloc. Some PROPVARIANT structures contain pointers, which can be freed by calling the PropVariantClear function. It is up to the caller of the GetValue method to call PropVariantClear.


Minimum supported client

Windows 2000 Professional [desktop apps only]

Minimum supported server

Windows 2000 Server [desktop apps only]

End of client support

Windows 7

End of server support

Windows Server 2008 R2



See also




© 2017 Microsoft