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.