| Directory Services |
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.
| Method | Description |
|---|---|
| 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