webadmin::IpServices Interface Reference

Public Member Functions
void	get (out IpServiceList list, out long totalItems, in kerio::web::SearchQuery query)
void	create (out kerio::web::ErrorList errors, out kerio::web::CreateResultList result, in IpServiceList services)
void	set (out kerio::web::ErrorList errors, in kerio::web::StringList serviceIds, in IpService details)
void	remove (out kerio::web::ErrorList errors, in kerio::web::StringList serviceIds)
void	apply (out kerio::web::ErrorList errors)
void	reset ()

Member Function Documentation

void webadmin::IpServices::apply

(

out kerio::web::ErrorList

errors

)

write changes cached in manager to configuration

Parameters

errors

- list of errors 8001 Invalid params. - "Unable to add/modify service %1, wrong parameters." 8002 Database error. - "Unable to add/modify service %1." 8002 Database error. - "Unable to delete the service."

Exceptions

kerio::web::ApiException

-32001 Session expired. - "The user is not logged in." 1004 Access denied. - "Insufficient rights to perform the requested operation."

void webadmin::IpServices::create	(	out kerio::web::ErrorList	errors,
		out kerio::web::CreateResultList	result,
		in IpServiceList	services
	)

add new services

Parameters

errors	- list of errors 1001 Already exists. - "Service %1 already exists."
result	- list of IDs assigned to each item
services	- details for new services. field id is assigned by the manager to temporary value until apply() or reset().

Exceptions

kerio::web::ApiException

-32001 Session expired. - "The user is not logged in." 1004 Access denied. - "Insufficient rights to perform the requested operation."

void webadmin::IpServices::get	(	out IpServiceList	list,
		out long	totalItems,
		in kerio::web::SearchQuery	query
	)

get the list of services

Parameters

list	- list of services and it's details
totalItems	- count of all services on server (before the start/limit applied)
query	- conditions and limits. Included from weblib. Kerio Control engine implementation notes: LIKE matches substring (second argument) in a string (first argument). There are no wildcards. sort and match are case insensitive. column alias (first operand): "QUICKSEARCH" - requested operator applied as following: (name operator secondOperand ) || (description operator secondOperand)

Exceptions

kerio::web::ApiException

-32001 Session expired. - "The user is not logged in." 1004 Access denied. - "Insufficient rights to perform the requested operation."

void webadmin::IpServices::remove	(	out kerio::web::ErrorList	errors,
		in kerio::web::StringList	serviceIds
	)

remove services

Parameters

errors	- list of errors TODO write particular values
serviceIds	- ids of services that should be removed

Exceptions

kerio::web::ApiException

-32001 Session expired. - "The user is not logged in." 1004 Access denied. - "Insufficient rights to perform the requested operation."

void webadmin::IpServices::reset

(

)

discard changes cached in manager

Exceptions

kerio::web::ApiException

-32001 Session expired. - "The user is not logged in." 1004 Access denied. - "Insufficient rights to perform the requested operation."

void webadmin::IpServices::set	(	out kerio::web::ErrorList	errors,
		in kerio::web::StringList	serviceIds,
		in IpService	details
	)

update existing services

Parameters

errors	- list of errors 1001 Already exists. - "Service %1 already exists."
serviceIds	- ids of services to be updated.
details	- details for update. Field "kerio::web::KId" is ignored. All other fields must be filled and they are written to all services specified by serviceIds.

Exceptions

kerio::web::ApiException

-32001 Session expired. - "The user is not logged in." 1004 Access denied. - "Insufficient rights to perform the requested operation."

---

The documentation for this interface was generated from the following file:

• IpServices.idl