ICertSrvSetup-Schnittstelle (casetup.h)
Die ICertSrvSetup-Schnittstelle definiert Funktionen zum Installieren und Deinstallieren der Rollen Zertifizierungsstelle (Certification Authority, CA) und Zertifizierungsstelle-Webregistrierung auf einem Certificate Services-Computer .
Microsoft stellt eine Implementierung dieser Schnittstelle in der CCertSrvSetup-Klasse bereit . Zur Installation müssen Sie die InitializeDefaults-Methode aufrufen, bevor Sie auf Eigenschaften zugreifen oder andere Methoden für das CCertSrvSetup-Objekt aufrufen.
In C++ erstellen Sie eine instance dieser Schnittstelle, indem Sie die CoCreateInstance-Funktion mit dem CLSID_CCertSrvSetup Klassenbezeichner aufrufen.
Windows Server 2008 Standard: Die folgenden Dienste sind nicht verfügbar:
- Online-Antwortdienst
- Registrierungsdienst für Netzwerkgeräte
- V2-Vorlagen werden nicht unterstützt. Daher wird die automatische Registrierung nicht unterstützt.
- Delegierte Registrierungs-Agents werden nicht unterstützt.
- Die Rollentrennung wird nicht unterstützt.
Vererbung
Die ICertSrvSetup-Schnittstelle erbt von der IDispatch-Schnittstelle . ICertSrvSetup verfügt auch über folgende Arten von Membern:
Methoden
Die ICertSrvSetup-Schnittstelle verfügt über diese Methoden.
| ICertSrvSetup::CAImportPFX Importiert ein Zertifizierungsstelle-Zertifikat und den zugehörigen privaten Schlüssel in den lokalen Computerspeicher. |
| ICertSrvSetup::get_CAErrorId Ruft die ID für zusätzliche Fehlerinformationen im Zusammenhang mit einer Spezifikation einer fehlerhaften Zertifizierungsstelle ab. |
| ICertSrvSetup::get_CAErrorString Ruft die Zeichenfolgendaten für zusätzliche Fehlerinformationen ab, die sich auf eine Spezifikation einer fehlerhaften Zertifizierungsstelle beziehen. |
| ICertSrvSetup::GetCASetupProperty Ruft einen Eigenschaftswert für eine Zertifizierungsstelle-Konfiguration ab. |
| ICertSrvSetup::GetExistingCACertificates Ruft die Auflistung der CertSrvSetupKeyInformation-Objekte ab, die gültige Zertifizierungsstellenzertifikate darstellen, die derzeit auf dem Computer installiert sind. |
| ICertSrvSetup::GetHashAlgorithmList Ruft die Liste der Hashalgorithmen ab, die vom angegebenen Kryptografiedienstanbieter (CSP) für einen Algorithmus für asymmetrische Signaturschlüssel unterstützt werden. |
| ICertSrvSetup::GetKeyLengthList Ruft die Liste der Schlüssellängen ab, die vom angegebenen Kryptografiedienstanbieter (CSP) unterstützt werden. (ICertSrvSetup.GetKeyLengthList) |
| ICertSrvSetup::GetPrivateKeyContainerList Ruft die Liste der Schlüsselcontainernamen ab, die vom angegebenen Kryptografiedienstanbieter (CSP) für asymmetrische Signaturschlüsselalgorithmen gespeichert sind. |
| ICertSrvSetup::GetProviderNameList Ruft die Liste der Kryptografiedienstanbieter (Kryptografiedienstanbieter, CSPs) ab, die asymmetrische Schlüsselsignaturalgorithmen auf dem Computer bereitstellen. |
| ICertSrvSetup::GetSupportedCATypes Ruft die Typen von Zertifizierungsstellen ab, die auf einem Computer im Aufruferkontext installiert werden können. |
| ICertSrvSetup::InitializeDefaults Initialisiert ein CCertSrvSetup-Objekt mit Standardwerten, um die Installation der Rolle Zertifizierungsstelle zu ermöglichen. |
| ICertSrvSetup::Install Installiert eine Rolle wie im CCertSrvSetup-Objekt konfiguriert. |
| ICertSrvSetup::IsPropertyEditable Gibt dem Aufrufer an, ob eine angegebene Eigenschaft bearbeitet werden kann. |
| ICertSrvSetup::P ostUnInstall Ist nicht implementiert und für die zukünftige Verwendung reserviert. |
| ICertSrvSetup::P reUnInstall Speichert vorübergehend rollenspezifische Zustandsinformationen und deinstalliert dann die Rolle. |
| ICertSrvSetup::SetCADistinguishedName Legt einen allgemeinen Namen der Zertifizierungsstelle (Certification Authority, CA) und ein optionales Suffix für distinguished Name fest. |
| ICertSrvSetup::SetCASetupProperty Legt einen Eigenschaftswert für eine Zertifizierungsstelle -Konfiguration fest. |
| ICertSrvSetup::SetDatabaseInformation Legt die datenbankbezogenen Informationen für die Rolle zertifizierungsstelle (Ca) fest. |
| ICertSrvSetup::SetParentCAInformation Legt die Informationen der übergeordneten Zertifizierungsstelle für eine untergeordnete Zertifizierungsstelle fest. |
| ICertSrvSetup::SetWebCAInformation Legt die Informationen der Zertifizierungsstelle für die Webregistrierungsrolle der Zertifizierungsstelle fest. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Nicht unterstützt |
| Unterstützte Mindestversion (Server) | Windows Server 2008 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | casetup.h |