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
- 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 |