Content Provider Development Guide › Implementing the Content Provider CoClass › ICISContentProvider Interface Methods

ICISContentProvider Interface Methods

GetInformation()

This method returns to a client an XML document entity which contains information about the Content Provider.

• A client uses this information for logging purposes, but also to verify that a function that it intends to use is supported (refer to the <Functions> element), and has the required characteristics (such as synchronous indexing).
• A client is responsible for verifying the XML schema version reported as supported by the Content Provider. A client which continues, and uses the Content Provider functions, is implicitly guaranteeing the Content Provider that it passes it XML according to that schema version.

CreateIndexerInstance()

The Content Provider returns to the client a pointer to an ICISContentIndexer interface. As this is COM, the interface pointer must have been AddRef()ed before being given out; it is the client’s responsibility to Release() it.

There is no restriction on the COM identity of the implementation behind the ICISContentIndexer interface, but the Content Provider must maintain logical separation of each “instance” thus returned, from other indexer instances, but also from query instances, and from other sessions.

CreateQueryInstance()

The Content Provider returns to the client a pointer to an ICISContentQuery interface.

There is no restriction on the COM identity of the implementation behind the ICISContentQuery interface, but the Content Provider must maintain logical separation of each “instance” thus returned from other query instances, but also from indexer instances, and from other sessions.