========================================================================
       CLUSTER ADMINISTRATOR EXTENSION : ClipBook Server
========================================================================


AppWizard has created this Cluster Administrator Extension DLL for you.
This DLL demonstrates the basics of modifying the interface of
Cluster Administrator and is also a starting point for writing your DLL.

This file contains a summary of what you will find in each of the files that
make up your Cluster Administrator Extension DLL.

ClipBook ServerEx.h
    This is the main header file for the DLL.  It declares the
    CClipBookServerApp class.

ClipBook ServerEx.cpp
    This is the main DLL source file.  It contains the class CClipBookServerApp.
    It also contains the OLE entry points required of inproc servers.

ClipBook ServerEx.rc
    This is a listing of all of the Microsoft Windows resources that the
    program uses.  It includes the icons, bitmaps, and cursors that are stored
    in the RES subdirectory.  This file can be directly edited in Microsoft
    Developer Studio.

res\ClipBook ServerEx.rc2
    This file contains resources that are not edited by Microsoft 
    Developer Studio.  You should place all resources not
    editable by the resource editor in this file.

ClipBook ServerEx.def
    This file contains information about the DLL that must be
    provided to run with Microsoft Windows.  It defines parameters
    such as the name and description of the DLL.  It also exports
    functions from the DLL.

ClipBook ServerEx.clw
    This file contains information used by ClassWizard to edit existing
    classes or add new classes.  ClassWizard also uses this file to store
    information needed to create and edit message maps and dialog data
    maps and to create prototype member functions.

ExtObj.h
    This is the header file which defines the classes which implement the
    COM interfaces by the Microsoft Windows NT Cluster Administrator program
    for adding property pages, wizard pages, or context menu items.  It
    defines the CExtObject class.

ExtObj.cpp
    This is the source file which implements the CExtObject class.

ExtObjID.idl
    This the Interface Definition Language source file for defining
    the COM object implemented by the extension DLL.  This is the object
    that will be loaded by the Cluster Administrator program.

RegExt.h
    This is the header file which declares the functions used to register
    the Cluster Administrator extension DLL with both the cluster and the
    client machine.

RegExt.cpp
    This is the source file which implements registration for the Cluster
    Administrator extension DLL.

/////////////////////////////////////////////////////////////////////////////
Other standard files:

StdAfx.h, StdAfx.cpp
    These files are used to build a precompiled header (PCH) file
    named ClipBook Server.pch and a precompiled types file named StdAfx.obj.

Resource.h
    This is the standard header file, which defines new resource IDs.
    Microsoft Developer Studio reads and updates this file.

/////////////////////////////////////////////////////////////////////////////
Property page files:

BasePage.h
    This is the header file which defines a class which provides base
    property page functionality for use by extension property pages.  It
    defines the CBasePropertyPage class.

BasePage.cpp
    This is the source file which implements the CBasePropertyPage class.

PropList.h
    This is the header file which defines classes for manipulating
    cluster property lists.  It defines the CClusPropList and CObjectProperty
    classes.

PropList.cpp
    This is the source file which implements the CClusPropList and
    CObjectProperty classes for manipulating cluster property lists.

ResProp.h
    This is the header file which defines a property page titled "Parameters"
    to add to property sheets for resources for which your extension DLL is
    written.  It defines the CClipBook ServerParamsPage class.

ResProp.cpp
    This is the source file which implements the CClipBook ServerParamsPage class.

ExtObjData.h
    This is the header file which defines functions for adding items to
    context menus, adding custom property sheets, and wizard pages.

ExtObjData.cpp
    This is the source file which defines functions for adding items to
    context menus, adding custom property sheets, and wizard pages.

/////////////////////////////////////////////////////////////////////////////
Other notes:

If the extension DLL extends a resource type (by default it does) then before
registering the extension DLL the resource type needs to be created.  If the
resource type has not been created then the registration command will return the
following:

    System error 5078 has occurred (0x000013d6).
    The specified resource type was not found.

To fix this, create the resource type as detailed in the resource DLL project's
ReadMe.txt and try the registration again.

To register your extension DLL so that it can be used with Cluster
Administrator (CluAdmin), copy DLL to each machine that Cluadmin will be run on
to administer the cluster and register the DLL with regsvr32.exe:

    regsvr32 "ClipBook ServerEx.dll"

It's recommended that the DLL be copied to each node of the cluster and
registered there as well.  Then from a machine with the DLL present enter the
following command:

    cluster [clustername] /RegAdminExt:"ClipBook ServerEx.dll"

If the machine is not a member of the cluster then the "[clustername]" portion
is required.

"TODO:" indicates a part of the source code you should add to or customize.

"NOTE:" indicates a point of interest in the source code.

This DLL requires that the MFC libraries be installed with Visual Studio or
you will encounter compile errors.


/////////////////////////////////////////////////////////////////////////////