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

Darüber hinaus verfügt der Zertifizierungsstelle-Dienst über eingeschränkte Funktionen:

• 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

Weitere Informationen

IDispatch