windows-server-2003/admin/activec/samples/benefits

README.TXT



BenefitsSvr Sample Readme 

Copyright (C) 1995-1998 Microsoft Corporation. All Rights Reserved. 



====================================================== 

Notes for BenefitsSvr

====================================================== 



BenefitsSvr is an ATL-based snap-in component for use

with the Microsoft Management Console.



The BenefitsSvr sample demonstrates advanced implementations

of version 1.0 and 1.1 MMC technologies. Version 1.1 of MMC is required

to run this sample, this can be obtained from

http://www.microsoft.com/management/mmc. For basic snap-in

functionality or help on using the ATL Snap-In Wizard,

please refer to the Microsoft Visual C++ 6.0 documentation.



Some of the features that BenefitsSvr demonstrates are:



* Extending the namespace

* Adding unique node types

* Enumerating nodes

* Adding OCX support

* Adding HTML support

* Customizing results

* Extending toolbars

* Extending menus

* Adding toolbar and menu command handlers

* Adding property page support

* Using property pages as snap-in wizards

* Using Taskpads (select the "view web resources" menu item

		on the "health & dental plan" node)



Implementation overviews and details, as well as

architectural notes, are included in the BenefitsSvr Help

system. With the BenefitsSvr snap-in inserted into the 

current MMC console, you can view context-sensitive

and topical help using the F1 function key.



To insert a BenefitsSvr snap-in into the current MMC

console, choose "Add/Remove Snap-in..." from the

"Console" menu. In the "Add/Remove Snap-in" dialog box,

click "Add...". Click the "Benefits (ATL

snap-in wizard sample)" list item and then click "OK" in

the "Add Standalone Snap-in" dialog box.

Click "OK" in the "Add/Remove Snap-in" dialog box to

dismiss it. A BenefitsSvr snap-in node should now be

displayed in your console.



Microsoft Visual C++ 6.0 must be installed in order to

build the BenefitsSvr sample. While a compiled binary is

included with this sample, the source for a Microsoft

Visual Basic 6.0 OCX is also included. If you wish to

modify the OCX, you must have Visual Basic 6.0 installed.



Proper registration of the BenefitsSvr sample and the

included OCX is required for its proper function. While

the BenefitsSvr is registered automatically by the Visual

C++ 6.0 build process, the included OCX must be registered

by hand. To register the OCX, move to the SampCtrl

directory and type:



	regsvr32 SampCtrl.ocx



After the process is complete, you should be presented with

a dialog box confirming successful registration of the control.



An item to be aware of, there have occasionally been some problems

in getting the include directories in VC++ 6.0 correct. The first

entry on your include list should be the MSSDK\include directory,

followed by the MSSDK\include\atl30 directory. Furthermore, to

get the help to function properly in this sample, you will have

to copy BENSVR.CHM by hand to the directory in which the sample

DLL is registered.