CreateClusterResourceType

The CreateClusterResourceType function creates a new resource type in a cluster.

DWORD WINAPI CreateClusterResourceType(
  HCLUSTER hCluster,           
  LPCWSTR lpszResourceTypeName,  
  LPCWSTR lpszDisplayName,     
  LPCWSTR lpszResourceTypeDll,  
  DWORD dwLooksAlivePollInterval,  
  DWORD dwIsAlivePollInterval  
);
 

Parameters

hCluster

[in] Handle to the cluster to receive the new resource type.

lpszResourceTypeName

[in] Pointer to the name of the new resource type. The specified name must be unique within the cluster.

lpszDisplayName

[in] Pointer to the display name for the new resource type. While the contents of lpszResourceTypeName should uniquely identify the resource type on all clusters, the contents of lpszDisplayName should be a localized friendly name for the resource, suitable for displaying to administrators.

lpszResourceTypeDll

[in] Pointer to the fully qualified name of the resource DLL for the new resource type.

dwLooksAlivePollInterval

[in] Default millisecond value to be used as the poll interval needed by the new resource type's LooksAlive function. The dwLooksAlivePollInterval parameter is used to set the resource type's LooksAlivePollInterval property.

dwIsAlivePollInterval

[in] Default millisecond value to be used as the poll interval needed by the new resource type's IsAlive function. The dwIsAlivePollInterval parameter is used to set the resource type's IsAlivePollInterval property.

Return Values

ERROR_SUCCESS

The operation was successful.

If the operation was unsuccessful, CreateClusterResourceType returns a Win32 error value.

Remarks

Developers of new resource types must keep in mind that the CreateClusterResourceType function only defines the resource type in the cluster database and registers the resource type with the Cluster Service. To complete the process of installing a new resource type in a cluster, developers must install the resource DLLs and Cluster Administrator extension DLLs for the new types on each node in the cluster. Also, if Cluster Administrator will be used on systems that are not member nodes, the extension DLLs must also be installed on those systems.

QuickInfo

  Version: Use Windows NT Server Enterprise Edition 4.0.
  Windows CE: Unsupported.
  Header: Declared in clusapi.h.