IUrlAccessor Interface

  • Article

Provides methods for processing an individual item in a content source whose URL is provided by the gatherer to the filter host.

IUrlAccessor Members

AddRequestParameter Requests a property-value set.
BindToFilter Binds the item being processed to the appropriate IFilter and retrieves a pointer to the IFilter.
BindToStream Binds the item being processed to an IStream interface [Structured Storage] data stream and retrieves a pointer to that stream.
GetCLSID Gets the CLSID for the document type of the URL item being processed.
GetDocFormat Gets the document format, represented as a Multipurpose Internet Mail Extensions (MIME) string.
GetFileName Retrieves the file name of the item, which the filter host uses for indexing. If the item does not exist in a file system and the IUrlAccessor::BindToStream method is implemented, this method returns the shell's System.ParsingPath property for the item.
GetHost Gets the host name for the content source, if applicable.
GetLastModified Gets the time stamp identifying when the URL was last modified.
GetRedirectedURL Gets the redirected URL for the current item.
GetSecurityDescriptor Gets the security descriptor for the URL item. Security is applied at query time, so this descriptor identifies security for read access.
GetSecurityProvider Gets the security provider for the URL.
GetSize Gets the size of the content designated by the URL.
IsDirectory Ascertains whether the item URL points to a directory.

Remarks

This is the main interface for pulling data from the content source. The Get... methods are for properties that are required by or useful to the filter host. Not all data sources have these properties. If the property returned by one of these methods is not meaningful for your data source, your protocol handler should return E_NOTIMPL.

The Bind... methods provide access to the data.

Although the protocol handler runs in the protocol host's multithreaded environment, each protocol handler runs in its own thread, employing one IUrlAccessor object at a time.

Interface Information

Inherits from IUnknown
Header and IDL files searchapi.h, urlaccsdk.idl
Minimum operating systems Windows XP Service Pack 2 (SP2) with Windows Desktop Search (WDS) 3.0, Windows Server 2003 Service Pack 1 (SP1) with Windows Desktop Search (WDS) 3.0, Windows Vista

See Also

Search Protocol Handler Error Messages, IUrlAccessor2, IUrlAccessor3, The Indexing Process