ICertAdmin-Schnittstelle (certadm.h)

Die ICertAdmin-Schnittstelle bietet Verwaltungsfunktionen für ordnungsgemäß autorisierte Clients.

Die ICertAdmin-Schnittstelle wird verwendet, um die folgenden Aufgaben auszuführen:

• Autorisieren oder verweigern Sie eine Zertifikatanforderung.
• Widerrufen eines ausgestellten Zertifikats.
• Lösen Sie die Generierung einer Zertifikatsperrliste (Certificate Revocation List , CRL) aus.
• Rufen Sie die aktuelle Zertifikatsperrliste für den Server ab.
• Bestimmen Sie, ob ein Zertifikat gültig ist.

Wenn Sie die ICertAdmin-Schnittstelle verwenden, haben Sie schreibgeschützten Zugriff auf Anforderungsattribute und Zertifikaterweiterungen, aber keinen direkten Zugriff auf andere Anforderungs- und Zertifikateigenschaften.

ICertAdmin ist in Certadm.h definiert. Wenn Sie ein Programm erstellen, verwenden Sie jedoch Certsrv.h als Includedatei. Certadm.dll stellt hingegen die Implementierung der ICertAdmin-Schnittstelle bereit. Die Typinformationen für diese Schnittstelle befinden sich ebenfalls in Certadml.dll, das mit dem Platform Software Development Kit (SDK) ausgeliefert wird.

Verwaltungsaufgaben verwenden DCOM. Code, der diese Schnittstellenmethode aufruft, wie in einer früheren Version von Certadm.h definiert, wird auf Windows-basierten Servern ausgeführt, solange der Client und der Server dasselbe Windows-Betriebssystem ausführen.

Certificate Services-Schnittstellen unterstützen sowohl Apartmentthreading- als auch Free-Threading-Modelle. Für einen besseren Durchsatz wird freies Threading empfohlen.

Vererbung

Die ICertAdmin-Schnittstelle erbt von der IDispatch-Schnittstelle . ICertAdmin verfügt auch über die folgenden Arten von Membern:

Methoden

Die ICertAdmin-Schnittstelle verfügt über diese Methoden.

ICertAdmin::D enyRequest Verweigert eine angegebene Zertifikatanforderung, die aussteht.
ICertAdmin::GetCRL Ruft die aktuelle Zertifikatsperrliste (Certificate Revocation List, CRL) für die Zertifizierungsstelle (Certificate Services Certification Authority, CA) ab.
ICertAdmin::GetRevocationReason Gibt den Grund zurück, aus dem ein Zertifikat widerrufen wurde. Diese Methode wurde zuerst in der ICertAdmin-Schnittstelle definiert.
ICertAdmin::ImportCertificate Übernimmt ein zuvor ausgestelltes Zertifikat und importiert es in die Datenbank der Zertifizierungsstelle. Diese Methode wurde zuerst in der ICertAdmin-Schnittstelle definiert.
ICertAdmin::IsValidCertificate Überprüft das Zertifikat anhand des Schlüssels der Zertifizierungsstelle und überprüft, ob das Zertifikat nicht widerrufen wurde. Diese Methode wurde zuerst in der ICertAdmin-Schnittstelle definiert.
ICertAdmin::P ublishCRL Sendet eine Anforderung an die Zertifizierungsstelle (Certificate Services Certification Authority, CA), um eine neue Zertifikatsperrliste (Certificate Revocation List, CRL) zu veröffentlichen. Diese Methode wurde zuerst in der ICertAdmin-Schnittstelle eingeführt.
ICertAdmin::ResubmitRequest Sendet die angegebene Zertifikatanforderung an das Richtlinienmodul für die angegebene Zertifizierungsstelle. Diese Methode wurde zuerst in der ICertAdmin-Schnittstelle eingeführt.
ICertAdmin::RevokeCertificate Widerruft ein Zertifikat entweder an einem angegebenen Datum oder sofort. Diese Methode wurde zuerst in der ICertAdmin-Schnittstelle definiert.
ICertAdmin::SetCertificateExtension Fügt dem Zertifikat, das als Antwort auf eine Zertifikatanforderung ausgestellt wurde, eine neue Erweiterung hinzu. Diese Methode wurde zuerst von der ICertAdmin-Schnittstelle definiert.
ICertAdmin::SetRequestAttributes Legt Attribute in der angegebenen ausstehenden Zertifikatanforderung fest. Diese Methode wurde zuerst in der ICertAdmin-Schnittstelle definiert.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	certadm.h (include Certsrv.h)