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.