|
int HostGroup::FindGroups |
( |
wstring |
wstrFilter, |
|
|
array |
vecFieldsToReturn, |
|
|
array |
vecFieldsToOrder, |
|
|
params |
pParams, |
|
|
int |
lMaxLifeTime, |
|
|
[out] wstring |
strAccessor |
|
) |
| |
Finds administration groups by using filtering strings.
Finds groups after filtering by the wstrFilter string and creates a server-side collection of the found administration groups. Search is performed in the hierarchy of Administration Servers.
- Parameters:
-
| wstrFilter | (wstring) string for filtering. Contains a condition for the List of the group attributes. See also Search filter syntax. |
| vecFieldsToReturn | (array) array of the administration group attribute names to return. See List of the group attributes for 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] | strAccessor | (wstring) result set ID. Identifier of the server-side ordered collection of the found administration groups. The result set is destroyed and associated memory is freed in the following cases:
|
- Returns:
- (int) number of the found administration groups.
- See also:
-
|