ICertView-Schnittstelle (certview.h)
Die ICertView-Schnittstelle ermöglicht ordnungsgemäß autorisierten Clients das Erstellen einer angepassten oder vollständigen Ansicht der Certificate Services-Datenbank.
Die ICertView-Schnittstelle wird verwendet, um die folgenden Aufgaben auszuführen:
- Stellen Sie eine Verbindung mit einem Certificate Services-Server her.
- Rufen Sie eine Zeilenaufzählungssequenz der Zeilen in der Certificate Services-Datenbank ab.
- Rufen Sie eine Spaltenaufzählungssequenz für die Spalten einer Zeile in der Certificate Services-Datenbank ab.
- Rufen Sie die Spaltenanzahl und den Index ab.
- Geben Sie Sortier- und Qualifikationseinschränkungen für eine Spalte an.
- Geben Sie die Anzahl der Spalten und eine bestimmte Spalte in einer angepassten Ansicht an.
In C++ wird die ICertView-Schnittstelle durch einen Aufruf der COM-Funktion CoCreateInstance instanziiert. Wenn Sie hingegen Visual Basic Scripting Edition verwenden, müssen Sie auf die CertAdm Type-Bibliothek in Ihrem Projekt verweisen und dann das CCertView-Objekt durch einen Aufruf von "New" instanziieren. Der Beispielcode für die
Die ICertView::OpenConnection-Methode veranschaulicht die Instanziierungstechniken.
Die ICertView-Schnittstelle ist in Certview.h definiert. Wenn Sie Ihr Programm erstellen, verwenden Sie jedoch Certsrv.h als Include-Datei. Certadm.dll stellt die ICertView-Schnittstelle bereit. Die Typinformationen für diese Schnittstelle befinden sich ebenfalls in Certadml.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 ICertView-Schnittstelle erbt von der IDispatch-Schnittstelle . ICertView verfügt auch über folgende Arten von Membern:
Methoden
Die ICertView-Schnittstelle verfügt über diese Methoden.
| ICertView::EnumCertViewColumn Ruft eine instance einer Spaltenaufzählungssequenz für das Datenbankschema ab. |
| ICertView::GetColumnCount Ruft die Anzahl der Spalten in der Ansicht der Zertifikatdienste-Datenbank ab. |
| ICertView::GetColumnIndex Ruft den nullbasierten Index einer Spalte ab. |
| ICertView::OpenConnection Stellt eine Verbindung mit einem Certificate Services-Server her. |
| ICertView::OpenView Öffnet eine Ansicht für eine Certificate Services-Datenbank und instanziiert eine instance eines IEnumCERTVIEWROW-Objekts. |
| ICertView::SetRestriction Legt die Sortier- und Qualifikationseinschränkungen für eine Spalte fest. |
| ICertView::SetResultColumn Gibt eine Spalte für das Resultset einer angepassten Ansicht der Zertifikatdienste-Datenbank an. |
| ICertView::SetResultColumnCount Gibt die maximale Anzahl von Spalten für das Resultset einer benutzerdefinierten Ansicht der Zertifikatdienste-Datenbank an. |
Anforderungen
| Anforderung | Wert |
|---|---|
| Unterstützte Mindestversion (Client) | Nicht unterstützt |
| Unterstützte Mindestversion (Server) | Windows Server 2003 [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | certview.h (include Certsrv.h) |