IUrlAccessor interface
Provides methods for processing an individual item in a content source whose URL is provided by the gatherer to the filter host.
Members
The IUrlAccessor interface inherits from the IUnknown interface. IUrlAccessor also has these types of members:
Methods
The IUrlAccessor interface has these methods.
| Method | Description |
|---|---|
| AddRequestParameter |
Requests a property-value set. |
| BindToFilter |
Binds the item being processed to the appropriate IFilterand 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.
Requirements
|
Minimum supported client |
Windows XP with SP2, Windows Vista [desktop apps only] |
|---|---|
|
Minimum supported server |
Windows Server 2003 with SP1 [desktop apps only] |
|
Redistributable |
Windows Desktop Search (WDS) 3.0 |
|
Header |
|
|
IDL |
|
See also
- Reference
- Search Protocol Handler Error Messages
- IUrlAccessor2
- IUrlAccessor3
- Conceptual
- The Indexing Process