The IPersistQuery interface is is used to store and retrieve query parameters to and from persistent storage. This storage pertains to the query parameters, not the results of a query. A pointer to this interface is provided to a query form extension in the CQPM_PERSIST message. An application can also provide its own IPersistQuery implementation by passing a pointer to this interface to the query handler in the pPersistQuery member of the OPENQUERYWINDOW structure when ICommonQuery::OpenQueryWindow is called.
The IPersistQuery interface inherits the methods of the standard COM interface IUnknown.
In addition, IPersistQuery defines the following methods, including those inherited from IPersist.
|WriteString||Writes a string to the query store.|
|ReadString||Reads a string from the query store.|
|WriteInt||Writes an integer value to the query store.|
|ReadInt||Reads an integer value from the query store.|
|WriteStruct||Writes a structure to the query store.|
|ReadStruct||Reads a structure from the query store.|
|Clear||Empties the contents of the query store.|
Client: Included in Windows XP and
Windows 2000 Professional.
Server: Included in Windows Server 2003 and Windows 2000 Server.
Header: Declared in Cmnquery.h.
CQPM_PERSIST, OPENQUERYWINDOW, ICommonQuery::OpenQueryWindow, IPersist, Active Directory Display Interfaces