ICertConfig-Schnittstelle (certcli.h)

  • Artikel

Die ICertConfig-Schnittstelle bietet Funktionen zum Abrufen der öffentlichen Konfigurationsdaten (während der Clienteinrichtung angegeben) für einen Certificate Services-Server.

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

  • Führen Sie die Konfigurationszeichenfolgen für einen Certificate Services-Server im Konfigurationspunkt auf.
  • Rufen Sie die Standardkonfiguration für einen Certificate Services-Server ab.
  • Rufen Sie die Details einer bestimmten Certificate Services-Serverkonfiguration ab.
  • Setzen Sie die Konfiguration eines Certificate Services-Servers zurück.

Bei jeder Installation von Zertifikatdiensten befinden sich diese öffentlichen Konfigurationsdaten in der Certsrv.txt-Datei, die im freigegebenen Ordner, im Active Directory oder beidem vorhanden ist. Jeder Server, der zum Posten seiner Konfigurationsinformationen in Certsrv.txt eingerichtet ist, ist für ICertConfig sichtbar.

ICertConfig ist in Certcli.h definiert. Wenn Sie Ihr Programm erstellen, verwenden Sie jedoch Certsrv.h als Include-Datei. Certcli.dll stellt die ICertConfig-Schnittstelle bereit. Die Typinformationen für diese Schnittstelle befinden sich ebenfalls in Certclil.dll, das mit dem Platform Software Development Kit (SDK) ausgeliefert wird.

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

Vererbung

Die ICertConfig-Schnittstelle erbt von der IDispatch-Schnittstelle . ICertConfig verfügt auch über die folgenden Membertypen:

Methoden

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

 
ICertConfig::GetConfig

Ruft die Konfigurationszeichenfolge für einen Certificate Services-Server ab. Diese Methode wurde zuerst in der ICertConfig-Schnittstelle definiert.
ICertConfig::GetField

Ruft ein bestimmtes Feld aus dem aktuellen Datensatz der Konfigurationsdatenbank ab. Diese Methode wurde zuerst in der ICertConfig-Schnittstelle definiert.
ICertConfig::Next

Ruft den Index der nächsten verfügbaren Zertifikatdiensteserverkonfiguration im Konfigurationspunkt ab. Diese Methode wurde zuerst in der ICertConfig-Schnittstelle definiert.
ICertConfig::Reset

Setzt den Konfigurationsabfragestatus so zurück, dass er auf die Konfiguration des Zertifikatdiensteservers verweist, die für den angegebenen Konfigurationspunkt indiziert ist. Diese Methode wurde zuerst in der ICertConfig-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 certcli.h (include Certsrv.h)