Edit

Share via

ICertManageModule interface (certmod.h)

  • Article

The ICertManageModule interface is provided to retrieve information about a Certificate Services Policy or Exit module.

Inheritance

The ICertManageModule interface inherits from the IDispatch interface. ICertManageModule also has these types of members:

Methods

The ICertManageModule interface has these methods.

 
ICertManageModule::Configure

Displays the module user interface.
ICertManageModule::GetProperty

Retrieves a module's property value.
ICertManageModule::SetProperty

Allows a module to set a property value.

Remarks

The ICertManageModule interface provides a method to invoke the module user interface for setting and viewing configuration settings. Writers of Policy and Exit modules should implement the ICertManageModule interface (in addition to the ICertPolicy and ICertExit interfaces, respectively). An enterprise certification authority (CA) should always use the Microsoft-provided enterprise policy and exit modules; additional exit modules are permitted for enterprise CAs.

The following is an example of what could be used in the DECLARE_REGISTRY macro of a class (CMyCertManagePolicyModule) which implements ICertManageModule.

DECLARE_REGISTRY(
    CMyCertManagePolicyModule,
    L"MyCode.PolicyManage.1",
    L"MyCode.PolicyManage",
    IDS_CERTMANAGEPOLICYMODULE_DESC,
    THREADFLAGS_BOTH);

The IDS_CERTMANAGEPOLICYMODULE_DESC value is an application-specific identifier that identifies a string table string in the resource file (.rc) which describes the class.

ICertManageModule is defined in Certmod.h. When you create your program, however, use Certsrv.h as the include file.

Certificate Services interfaces support both apartment-threading and free-threading models. For better throughput, free threading is recommended.

In Visual Basic Scripting Edition, the name of the class that implements ICertManageModule must be either "PolicyManage" or "PolicyExit", depending on the type of module being created. The following string constants defined in Certmod.h may be used to simplify following the naming convention.

Constant Value
wszCERTMANAGEEXIT_POSTFIX TEXT(".ExitManage")
wszCERTMANAGEPOLICY_POSTFIX TEXT(".PolicyManage")

Requirements

Requirement Value
Minimum supported client None supported
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header certmod.h (include Certsrv.h)