Directory Services

IPersistQuery

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.

Methods in Vtable Order

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.

Requirements

Client: Included in Windows XP and Windows 2000 Professional.
Server: Included in Windows Server 2003 and Windows 2000 Server.
Header: Declared in Cmnquery.h.

See Also

CQPM_PERSIST, OPENQUERYWINDOW, ICommonQuery::OpenQueryWindow, IPersist, Active Directory Display Interfaces