OV_NodeGroup::GetNodeSet()
OV_NodeGroup::GetNodeSet_Trans()
- sint32 GetNodeSet(
- [out] OV_ManagedNode Nodes[],
- [in, optional] string PrimaryNodeNames[],
- [in, optional] string NodeNames[],
- [in, optional] string NodeGroupPaths[],
- [in, optional] string NodeGroupNames[] )
- sint32 GetNodeSet_Trans(
- [in] string TransId,
- [out] OV_ManagedNode Nodes[],
- [in, optional] string PrimaryNodeNames[],
- [in, optional] string NodeNames[],
- [in, optional] string NodeGroupPaths[],
- [in, optional] string NodeGroupNames[] )
Parameters
- TransId
- Transaction ID returned from OV_Transaction::Start().
- Nodes
- Set of nodes (instances of OV_ManagedNode) without duplicates.
- PrimaryNodeNames
- List of primary node names (PrimaryNodeName property of the OV_ManagedNode instance). Default is an empty list. If one of the nodes from this list does not exist, nothing happens, and the method fails with MDLAPI_E_NODE_NOT_EXIST.
- NodeNames
- List of node names (Name property of the OV_ManagedNode instance). Default is an empty list. If one of the nodes from this list does not exist, nothing happens, and the method fails with MDLAPI_E_NODE_NOT_EXIST.
- NodeGroupPaths
- List of node groups specified with a hierarchical path. Default is an empty list. If one of the node groups from this list does not exist, nothing happens, and the method fails with MDLAPI_E_NODEGROUP_NOT_EXIST.
- NodeGroupNames
- List of node group names (Name property of OV_NodeGroup instance). Default is an empty list. If one of the node groups from this list does not exist, nothing happens, and the method fails with MDLAPI_E_NODEGROUP_NOT_EXIST.
Calling Convention
These methods can be called from a WMI class or instance object.
Description
Returns a set of nodes (instances of OV_ManagedNode).
This method accepts different arrays (lists of nodes or node groups represented with IDs, primary node names, or hierarchical paths), and arranges them into a node set (node list without duplicate instances).
Return Value
Number of nodes in out parameter Nodes.
Extended Status Codes
- MDLAPI_E_NODE_NOT_EXIST
- Node does not exist.
- MDLAPI_E_NODE_PNNAME_NOT_UNIQUE
- More than one node with the specified Primary Node Name is found.
- MDLAPI_E_NODEGROUP_NOT_EXIST
- Node Group does not exist.
- MDLAPI_E_TRANSACTION_NOT_EXIST
- Transaction with the specified ID does not exist.