Cluster Administrator Extension API

The Cluster Administrator Extension API allows developers of custom resource types to create an extension DLL for administering resources associated with these new types with resources associated with the standard Cluster Server types. Implementing a Cluster Administrator extension DLL enables all resource types to be administered with a consistent, graphical interface. To insure this consistency, Cluster Server requires that anyone implementing a resource DLL also implement a Cluster Administrator extension DLL.

The Cluster Administrator Extension API consists of interfaces based on the Component Object Model (COM). Most of these interfaces are implemented by Cluster Administrator and called by the extension. Only a few are implemented by the extension directly. The interfaces are defined in the CLUADMEX.IDL file and the CLUADMEX.H header file. Related to the COM-based API are several functions that are used for registering an extension DLL with Cluster Administrator.

A Cluster Administrator extension DLL is implemented as an in-process server. An in-process server provides a service, such as a property page that displays resource properties, to clients with a specific set of COM interfaces. These interfaces are made available through objects represented by unique identifiers called class identifiers (CLSID). In-process servers include these CLSIDs in the system registry to enable them to be recognized by the clients that require their services.

Cluster Administrator extensions can be created with or without the Resource Type AppWizard provided with the Microsoft® Developer Studio™ visual development system. Using the Resource Type AppWizard saves time and effort by producing a Cluster Administrator extension that is complete and fully operational. For more information about using the Resource Type AppWizard to generate a Cluster Administrator extension, see Using the Resource Type AppWizard.

The Cluster Administrator extension created by the Resource Type AppWizard relies on the ActiveX Template Library (ATL) version 1.1. Developers creating Cluster Administrator extensions without using the AppWizard can base their extensions on ATL classes, classes from an alternate class library, or implement their classes without a library. Using ATL is recommended because it is an effective way to implement a Cluster Administrator extension.