This library is free software; you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation; either version 2.1 of the License, or (at your option) any later version.

This library is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.

You should have received a copy of the GNU Lesser General Public License along with this library; if not, write to the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.

The Query interface provides a convienient way for clients to retrieve a subset of the accounts satisfying certain conditions.

This is basically the same API proposed by Zdra

Find all accounts which match the search query.

An empty parameter should return all accounts

The search query data. The keys can be any Connection Manager parameter (in which case they must be prepended with the string "param-"), any readable Account property (in the form Interface.PropertyName) or any of these special keys:

s: Manager
s: Protocol
u: RequestedPresence
s: RequestedStatus
u: CurrentPresence
s: CurrentStatus

The array of account objects. A list of the special keywords recognized by the FindAccounts method.

It's likely that some new keywords will be added later, or that different implementation of this interface will support a different set of keywords; in such a scenario it seems proper to inform the client about supported keywords.

But I'm not sure this is really needed.