OV_Service::GetByHierarchicalPath()
OV_Service::GetByHierarchicalPath_Trans()

OV_Service GetByHierarchicalPath(

[in] string Path)

OV_Service GetByHierarchicalPath_Trans(

[in] string TransId,

[in] string Path)

Parameters

TransId

Transaction ID returned from OV_Transaction::Start().

Path

The service specified by the hierarchy Path. The Path consists of the Caption/Display Names of parent Services and a single backslash as a separator. The Path starts with a single backslash. If some of the Captions contain backslashes, you should escape them with additional backslashes (for example, "\\"). If the service with the specified Path 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 service (instance of OV_Service) specified by the hierarchical path.

Return Value

Instance of OV_Service specified by the hierarchical path.

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.