ICertView::SetResultColumnCount-Methode (certview.h)

Artikel
02/23/2024

Die SetResultColumnCount-Methode gibt die maximale Anzahl von Spalten für den Resultset einer angepassten Ansicht der Certificate Services-Datenbank an.

Syntax

HRESULT SetResultColumnCount(
  [in] LONG cResultColumn
);

Parameter

[in] cResultColumn

Gibt die maximale Anzahl von Spalten im Resultset an. Dieser Parameter kann auf eine positive Zahl oder auf 0 festgelegt werden, wenn Sie nur die Zeilen der Certificate Services-Datenbank zählen möchten, oder auf eine der folgenden Konstanten.

Wert	Bedeutung
CV_COLUMN_LOG_DEFAULT	Die Anzahl der Spalten im Resultset entspricht der Anzahl der Spalten im Standardergebnissatz der Zertifikatdienste für aufgelöste Anforderungen. Eine Anforderung wird aufgelöst, wenn sie zu einem ausgestellten Zertifikat oder einer fehlerhaften Anforderung geführt hat. widerrufene Zertifikate gelten als aufgelöst.
CV_COLUMN_LOG_FAILED_DEFAULT	Die Anzahl der Spalten im Resultset entspricht der Anzahl von Spalten im Standardergebnissatz der Zertifikatdienste für Anforderungen, bei denen ein Fehler aufgetreten ist.
CV_COLUMN_QUEUE_DEFAULT	Die Anzahl der Spalten im Resultset entspricht der Anzahl der Spalten im Standardergebnissatz der Zertifikatdienste für Anforderungen, die nicht aufgelöst wurden.

Rückgabewert

VB

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.

Hinweise

Vor dem Aufrufen der SetResultColumnCount-Methode muss eine Verbindung mit einem Certificate Services-Server hergestellt werden, indem zuerst die OpenConnection-Methode aufgerufen wird. Nachdem die Verbindung hergestellt wurde, kann diese Methode einmal und nur einmal aufgerufen werden, um die maximale Anzahl von Spalten im Resultset anzugeben.

Wenn der cResultColumn-Parameter auf eine positive Zahl (nicht eine der vordefinierten Konstanten) festgelegt ist, muss die SetResultColumn-Methode aufgerufen werden, um anzugeben, welche Spalten im Resultset enthalten sein sollen. Beachten Sie, dass SetResultColumn fehlschlägt, wenn mehr als die anzahl von SetResultColumnCount angegebenen Spalten aufgerufen wird.

Beispiele

HRESULT    hr;
// Specify the result set for logged requests.
// pCertView is pointer to ICertView (which has an Open Connection)
hr = pCertView->SetResultColumnCount(CV_COLUMN_LOG_DEFAULT);
if (S_OK != hr)
    printf("Failed ICertView::SetResultColumnCount - %x\n", hr);
else
{
    // Retrieve data rows by means of ICertView::OpenView.
    // ...
}

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)
Bibliothek	Certidl.lib
DLL	Certadm.dll