KSC Open API  13.1
Kaspersky Security Center API description
HostGroup::FindHostsAsync ( wstring  wstrFilter,
array  vecFieldsToReturn,
array  vecFieldsToOrder,
params  pParams,
int  lMaxLifeTime,
[out] wstring  strRequestId 
)

Finds hosts asynchronously by using filtering by the string.

Asynchronously finds hosts by using filtering by the wstrFilter string and creates a server-side collection of found hosts. Search is performed in the hierarchy.

Parameters:
wstrFilter(wstring) string for filtering by the host attributes. See Search filter syntax.
vecFieldsToReturn(array) array of the host attribute names to return. See List of the host attributes to know the attribute names.
vecFieldsToOrder(array) array of containers, each of them containing two attributes:
pParams(params) extra options. The possible attributes are listed below (for more information, see Extra search attributes for hosts and administration groups):
  • KLSRVH_SLAVE_REC_DEPTH
  • KLGRP_FIND_FROM_CUR_VS_ONLY
lMaxLifeTime(int) maximum lifetime of the result set, in seconds. Can accept the value no more than 7200.
[out]strRequestId(wstring) ID of an asynchronous operation. To get a status, use AsyncActionStateChecker.CheckActionState. lStateCode "1" means OK and "0" means failure. To get an accessor ID, call HostGroup.FindHostsAsyncGetAccessor. To cancel operation, call HostGroup.FindHostsAsyncCancel.
See also: