Export (0) Print
Expand All

CreateClusterGroup function

Adds a group to a cluster and returns a handle to the newly added group. The PCLUSAPI_CREATE_CLUSTER_GROUP type defines a pointer to this function.

Syntax


HGROUP WINAPI CreateClusterGroup(
  _In_  HCLUSTER hCluster,
  _In_  LPCWSTR lpszGroupName
);

typedef HGROUP (WINAPI *PCLUSAPI_CREATE_CLUSTER_GROUP)(
    _In_  HCLUSTER hCluster,
    _In_  LPCWSTR lpszGroupName
);

Parameters

hCluster [in]

Handle to the target cluster.

lpszGroupName [in]

Pointer to a null-terminated Unicode string containing the name of the group to be added to the cluster identified by hCluster. If there is not a group by this name, CreateClusterGroup creates it.

Return value

If the operation succeeds, the function returns a group handle.

If the operation fails, the function returns NULL. For more information about the error, call GetLastError.

Remarks

Do not call CreateClusterGroup from a resource DLL. For more information, see Function Calls to Avoid in Resource DLLs.

The CreateClusterGroup function calls the CreateClusterGroupEx function with a NULL CLUSTER_CREATE_GROUP_INFO. The new group is created with a group type of ClusGroupTypeUnknown.

Examples

See Creating Groups.

Requirements

Minimum supported client

None supported

Minimum supported server

Windows Server 2003 Enterprise, Windows Server 2003 Datacenter

Header

ClusAPI.h

Library

ClusAPI.lib

DLL

ClusAPI.dll

See also

OpenClusterGroup

 

 

Show:
© 2015 Microsoft