Inform the agents on the specified systems to change the HPOM primary manager to the calling HPOM for Windows management server.
Parameters
If an exact match cannot be found, the behavior is as follows: If a node is specified without a domain, it is compared with a short name (until the first '.') in all OV_ManagedNode WMI instances that have entered FQDN as a Primary Node Name. Otherwise, if a node is specified with FQDN, a short name (until the first '.') is compared with an exact match (also a short name) in OV_ManagedNode WMI instances.
If more than one matching OV_ManagedNode WMI instance is found, an error is reported.
Node groups in the path are identified with the node group caption (that is, the Caption property of the OV_NodeGroup WMI instance).
Returning Parameter
None.
HRESULT Return Values
Description
With the BecomePrimMgrAsync method, the calling HPOM for Windows management server becomes the HPOM primary manager on specified systems. The HPOM primary manager can be set for each subagent separately by a specified subagent ID with the parameter nSubAgentId. The default is 0 (all subagents).
Nodes are specified with some or all of the following parameters:
If any parameter is not used, it should be passed to the method as an empty Variant.
Even when the node is included in more than one parameter, remote administration is performed only once.
To also include all subgroups of the specified node group, call the method with the parameter bInclSubGroups set to VARIANT_TRUE. It defaults to VARIANT_FALSE (subgroups will not be enumerated).
To specify all managed nodes, specify the string with a single backslash character ("\") as the parameter varNodeGroupPaths, leave the parameters varNodePrimNames, varNodeIds, and varNodeGroupIds empty, and set the parameter bInclSubGroups to VARIANT_TRUE.
This is an asynchronous method. For a comparison of the synchronous and asynchronous methods, see the description of the IOvRemoteAgent interface.