ICertSrvSetup interface (casetup.h)

The ICertSrvSetup interface defines functionality to install and uninstall Certification Authority (CA) and Certification Authority Web Enrollment roles on a Certificate Services computer.

Microsoft provides an implementation of this interface in the CCertSrvSetup class. For installation, you must call the InitializeDefaults method before accessing any properties or calling any other methods on the CCertSrvSetup object.

In C++, you create an instance of this interface by calling the CoCreateInstance function with the CLSID_CCertSrvSetup class identifier.

Windows Server 2008 Standard:  The following services are not available:

  • Online Responder Service
  • Network Device Enrollment Service
In addition, the certification authority (CA) service has limited functionality:
  • V2 templates are not supported; therefore, autoenrollment is not supported.
  • Delegated enrollment agents are not supported.
  • Role separation is not supported.

Inheritance

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

Methods

The ICertSrvSetup interface has these methods.

 
ICertSrvSetup::CAImportPFX

Imports a certification authority (CA) certificate and its associated private key into the local computer store.
ICertSrvSetup::get_CAErrorId

Gets the ID for additional error information related to a failed certification authority (CA) specification.
ICertSrvSetup::get_CAErrorString

Gets the string data for additional error information related to a failed certification authority (CA) specification.
ICertSrvSetup::GetCASetupProperty

Gets a property value for a certification authority (CA) configuration.
ICertSrvSetup::GetExistingCACertificates

Gets the collection of CertSrvSetupKeyInformation objects that represent valid certification authority (CA) certificates currently installed on the computer.
ICertSrvSetup::GetHashAlgorithmList

Gets the list of hash algorithms supported by the specified cryptographic service provider (CSP) for an asymmetric signature key algorithm.
ICertSrvSetup::GetKeyLengthList

Gets the list of key lengths supported by the specified cryptographic service provider (CSP). (ICertSrvSetup.GetKeyLengthList)
ICertSrvSetup::GetPrivateKeyContainerList

Gets the list of key container names stored by the specified cryptographic service provider (CSP) for asymmetric signature key algorithms.
ICertSrvSetup::GetProviderNameList

Gets the list of cryptographic service providers (CSPs) that provide asymmetric key signature algorithms on the computer.
ICertSrvSetup::GetSupportedCATypes

Gets the types of certification authorities (CAs) that can be installed on a computer under the caller context.
ICertSrvSetup::InitializeDefaults

Initializes a CCertSrvSetup object with default values to enable installation of the Certification Authority role.
ICertSrvSetup::Install

Installs a role as configured in the CCertSrvSetup object.
ICertSrvSetup::IsPropertyEditable

Indicates to the caller whether a specified property can be edited.
ICertSrvSetup::PostUnInstall

Is not implemented and is reserved for future use.
ICertSrvSetup::PreUnInstall

Temporarily saves role-specific state information and then it uninstalls the role.
ICertSrvSetup::SetCADistinguishedName

Sets a certification authority (CA) common name and an optional distinguished name suffix.
ICertSrvSetup::SetCASetupProperty

Sets a property value for a certification authority (CA) configuration.
ICertSrvSetup::SetDatabaseInformation

Sets the database related information for the certification authority (CA) role.
ICertSrvSetup::SetParentCAInformation

Sets the parent certification authority (CA) information for a subordinate CA configuration.
ICertSrvSetup::SetWebCAInformation

Sets the certification authority (CA) information for the Certification Authority Web Enrollment role.

Requirements

Requirement Value
Minimum supported client None supported
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header casetup.h

See also

IDispatch