HP Operations Manager for Windows

OV_Service::GetServiceSet()
OV_Service::GetServiceSet_Trans()


sint32 GetServiceSet(
[out] OV_Service Services[],
[in, optional] string ServiceNames[],
[in, optional] string ServicePaths[],
[in, optional] string ParentServiceNames[],
[in, optional] string ParentServicePaths[] )
sint32 GetServiceSet_Trans(
[in] string TransId,
[out] OV_Service Services[],
[in, optional] string ServiceNames[],
[in, optional] string ServicePaths[],
[in, optional] string ParentServiceNames[],
[in, optional] string ParentServicePaths[] )

Parameters

TransId
Transaction ID returned from OV_Transaction::Start().
Services
Set of services (instances of OV_Service) without duplicates.
ServiceNames
List of service names (Name property of OV_Service instance). Default is an empty list. If one of the services in the list does not exist, nothing happens, and the method fails with MDLAPI_E_SERVICE_NOT_EXIST.
ServicePaths
List of services specified with the hierarchical path. Default is an empty list. If one of the services in the list does not exist, nothing happens, and the method fails with MDLAPI_E_SERVICE_NOT_EXIST.
ParentServiceNames
List of parent service names (Name property of OV_Service instance). All services from this list and their children are found and included in a result list. Default is an empty list. If one of the services from this list does not exist, nothing happens, and the method fails with MDLAPI_E_SERVICE_NOT_EXIST.
ParentServicePaths
List of services specified with a hierarchical path. All services from this list and their children are found and included in a result list. Default is an empty list. If one of the services from this list does not exist, nothing happens, and the method fails with MDLAPI_E_SERVICE_NOT_EXIST.

Calling Convention

These methods can be called from a WMI class or instance object.

Description

Returns the set of services (instances of OV_Service).

This method accepts different arrays (lists of services represented with IDs or hierarchical paths), and arranges them into service sets (service lists without duplicate instances). The method also verifies that service instances exist. If one of them does not exist, the method fails with MDLAPI_E_SERVICE_NOT_EXIST.

Return Value

Number of services in out parameter Services.

Extended Status Codes

MDLAPI_E_SERVICE_NOT_EXIST
Service does not exist.
MDLAPI_E_TRANSACTION_NOT_EXIST
Transaction with the specified ID does not exist.