OV_NodeGroup::Create()
OV_NodeGroup::Create_Trans()

OV_NodeGroup Create(

[in] string Caption,

[in] string ParentName,

[in, optional] string Name,

[in, optional] string Description)

OV_NodeGroup Create_Trans(

[in] string TransId,

[in] string Caption,

[in] string ParentName,

[in, optional] string Name,

[in, optional] string Description)

Parameters

TransId

Transaction ID returned from OV_Transaction::Start().

Caption

The Caption property of the instance of OV_NodeGroup to be created. If a node group with the same Caption already exists on the same hierarchy path level (as a child of the same parent), nothing happens, and the method fails with MDLAPI_E_NODEGROUP_HIERPATH_EXISTS. If the Caption parameter is an empty string, contains invalid characters, or has more then 1024 characters, the method fails with MDLAPI_E_INVALID_CAPTION.

ParentName

The Name property of the instance of OV_NodeGroup to which the newly created node group is added. If the specified node group does not exist, the method fails with MDLAPI_E_PARENT_NODEGROUP_NOT_EXIST.

Name

The Name property of the instance of OV_NodeGroup to be created. Optional parameter. If you do not specify this parameter, or if it is equal to an empty string, it is created as a new GUID. If a Node Group with the same Name already exists, nothing happens, and the method fails with MDLAPI_E_NODEGROUP_NAME_EXISTS.

Description

The Description property of the instance of OV_NodeGroup to be created. Optional parameter.

Calling Convention

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

Description

Creates a node group (new instance of OV_NodeGroup).

Return Value

Instance of the newly created OV_NodeGroup.

Extended Status Codes

MDLAPI_E_INVALID_CAPTION

Specified object Caption parameter is not valid.

MDLAPI_E_PARENT_NODEGROUP_NOT_EXIST

Parent node group does not exist.

MDLAPI_E_NODEGROUP_NAME_EXISTS

Node Group with the same Name already exists.

MDLAPI_E_NODEGROUP_HIERPATH_EXISTS

Node Group with the same hierarchy path (Caption) already exists.

MDLAPI_E_TRANSACTION_NOT_EXIST

Transaction with the specified ID does not exist.