ICertView::OpenView-Methode (certview.h)
Die OpenView-Methode öffnet eine Ansicht für eine Certificate Services-Datenbank und instanziiert eine instance eines IEnumCERTVIEWROW-Objekts.
Syntax
HRESULT OpenView(
[out] IEnumCERTVIEWROW **ppenum
);
Parameter
[out] ppenum
Ein Zeiger auf einen Zeiger vom Typ IEnumCERTVIEWROW .
Rückgabewert
C++
Wenn die Methode erfolgreich ist, gibt die Methode S_OK zurück.Wenn die Methode fehlschlägt, gibt sie einen HRESULT-Wert zurück, der den Fehler angibt. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.
VB
Der Rückgabewert ist ein IEnumCERTVIEWROW-Objekt .Hinweise
Vor dem Aufrufen der OpenView-Methode muss eine Verbindung mit einem Certificate Services-Server hergestellt werden, indem zuerst die OpenConnection-Methode aufgerufen wird.
Das von diesem Aufruf zurückgegebene IEnumCERTVIEWROW-Objekt stellt eine Zeilenaufzählungssequenz dar, deren interner Index auf den Anfang der Sequenz verweist. Um die erste Zeile in der Sequenz anzuzeigen, rufen Sie die
IEnumCERTVIEWROW::Next-Methode , die den internen Index in die erste Zeile verschiebt.
Um einen nicht standardmäßigen Spaltensatz oder eine Teilmenge der Zeilen anzuzeigen, rufen Sie SetResultColumnCount, SetResultColumn und SetRestriction nach dem Aufrufen von OpenConnection und vor dem Aufrufen von OpenView auf.
Beispiele
// pCertView is previously instantiated pointer to ICertView.
IEnumCERTVIEWROW * pEnumRow = NULL;
HRESULT hr;
hr = pCertView->OpenView(&pEnumRow);
if (S_OK != hr)
printf("Failed ICertView::OpenView - %x\n", hr);
else
// use pEnumRow as needed, to enumerate data rows
// ...
// Done processing, free resources.
if (NULL != pEnumRow)
pEnumRow->Release();
Anforderungen
| 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) |
| Bibliothek | Certidl.lib |
| DLL | Certadm.dll |