ICluster::Connect method

Connects to the specified cluster.

Syntax

HRESULT Connect(
  [in] BSTR clusterName
);

Parameters

• clusterName [in]
  The computer name of the cluster's head node (the head node is the node on which the Compute Cluster Service is installed). If your application is running on the head node, you can specify the node's name or use "localhost" as the name.

Return value

If the method succeeds, the return value is S_OK. Otherwise, the return value is an error code. To get a description of the error, call the ICluster::get_ErrorMessage method.

Remarks

To connect to the cluster, the user needs to have an account on the head node or be a member of the Guest Users, Power Users, or Administrators group.

You can use the following filter to look up the name of the head nodes in a domain in Active Directory:

(&(objectClass=ServiceConnectionPoint)(serviceClassName=MicrosoftComputeCluster))

Examples

For an example that shows how to connect to the cluster, see Connecting to the Cluster.

Requirements

See also

ICluster