IScheduler::Connect method

  • Article

Connects you 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 Microsoft HPC 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.

Remarks

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

You can use the HPC SDK to schedule jobs on Microsoft HPC Server 2008 and later HPC servers; you cannot use this SDK to schedule jobs on Microsoft Compute Cluster Server 2003 (CCS).

If you use Active Directory to look up the names of the head nodes in a domain, use the following filter:

(&(objectClass=ServiceConnectionPoint)(serviceClassName=MicrosoftComputeCluster)(keywords=*Version2*))

Examples

For an example, see Connecting to a Cluster.

Requirements

Product

HPC Pack 2008 R2 Client Utilities, HPC Pack 2008 Client Utilities

Type library

 Microsoft.Hpc.Scheduler.tlb

See also

IScheduler