IFilterRegistration2 Interface

The IFilterRegistration2 interface defines the methods and properties of, and is implemented by, the FilterRegistration2 object.

The FilterRegistration2 object provides methods for registering and un-registering an IFilter for use with SharePoint Portal Server.

Extends

IFilterRegistration interface

Methods

The following table shows methods of the FilterRegigistration2 interface, and a brief description of each.

Name Description
GetDefaultFilterExtList Gets a list of file name extensions that have been registered to use the default filter if no other IFilter is registered.
GetDefaultFilter Gets the default IFilter for the specified data source or content type. Inherited from IFilterRegistration.
LoadIFilterEx Gets the IFilter that is the most suitable for the specified content type. This method is inherited from IFilterRegistration, but is superceded by LoadFilter method of the LoadFilter object.
LoadIFilterFromStorageEx Gets the IFilter that is the most suitable for the content contained in an IStorage object. This method is inherited from IFilterRegistration, but is superceded by LoadIFilterFromStorage method of the LoadFilter object.
LoadIFilterFromStreamEx Gets the IFilter that is the most suitable for a Class ID retrieved from a stream variable. This method is inherited from IFilterRegistration, but is superceded by LoadFilterFromStream method of the LoadFilter object.
RegisterDefaultFilter Creates the necessary registry entries to set an IFilter as the default handler for a specified data source or content type. This method is inherited from IFilterRegistration.
RegisterDefaultFilterExtList Registers one or more file name extensions to use the default IFilter if no other IFilter is registered.
RegisterFilter Creates the necessary registry entries to set an IFilter as a handler for one or more data sources or content types. This method is inherited from IFilterRegistration and superceded by IFilterRegistrationEx in this interface.
RegisterFilterEx Creates the necessary registry entries to set an IFilter as a handler for one or more data sources or content types.
UnregisterDefaultFilter Removes the registry entries that set the specified IFilter as the default handler for a specified data source or content type. This method is inherited from IFilterRegistration.
UnregisterDefaultFilterExtList Removes registration information for one or more file name extensions that are registered to use the default IFilter if no other IFilter is registered.
UnregisterFilter Removes the registry entries that set the specified IFilter as a handler for one or more data sources or content types. This method is inherited from IFilterRegistration.
Requirements
  • Type Library
    None.
  • Inproc Server
    %Program Files%\Common Files\Microsoft Shared\MSSearch\Bin\tquery.dll
Remarks

Use these methods in the DLLRegisterServer and DLLUnregisterServer functions of your custom IFilter.

When IFilters use the methods provided in the IFilterRegistration2 interface, the following mapping styles are supported:

  • Map an IFilter to a file name extension. This is the standard mapping available for previous IFilter versions.
  • Map an IFilter to a particular Multipurpose Internet Mail Extension (MIME) encoding type.
  • Map an IFilter to particular data types for a specified indexing catalog.
  • Map an IFilter as the default filter for a data source for the indexing service.