//+-------------------------------------------------------------------------
//
//  THIS CODE AND INFORMATION IS PROVIDED "AS IS" WITHOUT WARRANTY OF
//  ANY KIND, EITHER EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO
//  THE IMPLIED WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A
//  PARTICULAR PURPOSE.
//
//  Copyright (c) Microsoft Corporation. All rights reserved.
//
//  AddGroup VC Sample: Adding a group to Active Directory
//
//--------------------------------------------------------------------------

Description
===========

ADEvent is a simple example of an Active Directory administrative 
notification handler.


A notification handler receives notifications when the user deletes, renames, 
moves or changes the properties of an object using one of the Active 
Directory administrative MMC the snap-ins. This sample will display text in 
the debugger when any of the methods are called. Any additional functionality 
must be added by the developer.

Sample Files
============
  *  ADEvent.cpp
  *  adevent.h
  *  adevent.def
  *  ADEvent.sln
  *  ADEvent.vcproj
  *  makefile
  *  readme.txt

Building the Sample
===================
When you build this sample using Visual Studio, be sure that you have the
INCLUDE directory for the Platform SDK set first in the Options list of
include files.

To build this sample
  1.  Open the solution ADEvent.sln.
  2.  From the Build menu, select Build.

You can also build this sample at a command prompt using the supplied
makefile.


Running the Sample
==================
Before the notification handler can be installed, it must be registered. To 
register the COM object, build the debug version of the DLL and execute the 
following from the command line, substituting the path where the DLL is 
located for "<path>":

regsvr32.exe /s /c <path>\ADEvent.dll


The notification handler must also be added to the display specifiers in 
Active Directory. The notification handler is registered under the 
dsUIAdminNotification attribute in the DisplaySpecifiers - <locale> - DS-UI-
Default-Settings container. <locale> refers to the locale identifier for the 
locale that the handler will be registered under. The handler must be added 
for all locales that it will be available for. 

The dsUIAdminNotification 
attribute is a multi-valued string attribute that takes the form "<entry 
number>,<CLSID>. <entry number> is an ordinal number and the first available 
number should be used, but duplicates are allowed. <CLSID> is the CLSID of 
the notification handler. For this sample, the value of this will be {08698521
-653C-4386-B206-DFA3C0F904E5}.


To test the notification handler, run, or attach to an existing instance of, 
the Active Directory Users and Computers MMC snap-in in a debugger. If any 
object displayed by the snap-in is deleted, renamed, moved or has a property 
change, the notification handler will be instantiated and notified of the 
event.