IUrlAccessor interface (searchapi.h)
Provides methods for processing an individual item in a content source whose URL is provided by the gatherer to the filter host.
Inheritance
The IUrlAccessor interface inherits from the IUnknown interface. IUrlAccessor also has these types of members:
Methods
The IUrlAccessor interface has these methods.
| IUrlAccessor::AddRequestParameter Requests a property-value set. |
| IUrlAccessor::BindToFilter Binds the item being processed to the appropriate IFilterand retrieves a pointer to the IFilter. |
| IUrlAccessor::BindToStream Binds the item being processed to an IStream interface [Structured Storage] data stream and retrieves a pointer to that stream. |
| IUrlAccessor::GetCLSID Gets the CLSID for the document type of the URL item being processed. |
| IUrlAccessor::GetDocFormat Gets the document format, represented as a Multipurpose Internet Mail Extensions (MIME) string. |
| IUrlAccessor::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. |
| IUrlAccessor::GetHost Gets the host name for the content source, if applicable. |
| IUrlAccessor::GetLastModified Gets the time stamp identifying when the URL was last modified. |
| IUrlAccessor::GetRedirectedURL Gets the redirected URL for the current item. |
| IUrlAccessor::GetSecurityDescriptor Gets the security descriptor for the URL item. Security is applied at query time, so this descriptor identifies security for read access. |
| IUrlAccessor::GetSecurityProvider Gets the security provider for the URL. |
| IUrlAccessor::GetSize Gets the size of the content designated by the URL. |
| IUrlAccessor::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.
Requirements
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP with SP2, Windows Vista [desktop apps only] |
| Minimum supported server | Windows Server 2003 with SP1 [desktop apps only] |
| Target Platform | Windows |
| Header | searchapi.h |
| Redistributable | Windows Desktop Search (WDS) 3.0 |
See also
Conceptual
Reference