windows-server-2003/ds/security/services/ca/exit/sample

The source code in this directory can be used to build a sample Exit Module

for Microsoft Certificate Services.  It is meant to run on Windows 2000 or

later.  Certificate Services must already be installed.



Certificate Services calls the Exit Module through the ICertExit interface,

and the Exit Module can call back to Certificate Services through the

ICertServerExit interface.



Each time Certificate Services issues a certificate, it passes control to

the ICertExit::Notify method in exit.cpp, specifying that a certificate

has been issued.  The passed Context parameter is used with the ICertServerExit

interface to retrieve properties from the newly issued certificate.



Once the certxsam.dll DLL is built, its COM interface must be registered

via the following command:

    regsvr32 certxsam.dll



Once registered, the Certification Authority management console snapin can

be used to make this exit module active.



and the Certificate Services service must be stopped and restarted to load

the newly registered Exit Module.  Use the Control Panel's Services applet,

and stop and restart the "Certificate Services" service.



If you wish to see the debug print output from the sample Exit Module,

attach a debugger to the running service process, or stop the Certificate

Services service, then start Certificate Services as a console application

via the following command:

    certsrv -z



Files:

------

atl.cpp      -- ActiveX Template Library COM support code



ceerror.cpp  -- Implements error handling routines



celib.cpp    -- Implements support routines



certxsam.cpp -- Implements COM and initialization entry points:

			DllMain

			DllCanUnloadNow

			DllGetClassObject

			DllRegisterServer

			DllUnregisterServer



certxsam.def -- Exports COM entry points



certxsam.idl -- Interface Definitions



certxsam.rc  -- Version Resource



exit.cpp     -- Implements ICertExit



exit.h       -- Implements ICertExit



module.cpp   -- Implements ICertManageModule



module.h     -- Implements ICertManageModule



pch.cpp      -- Precompiled Header file



resource.h   -- Resource ID definitions