ICertView::SetResultColumn-Methode (certview.h)
Die SetResultColumn-Methode gibt eine Spalte für den Resultset einer angepassten Ansicht der Certificate Services-Datenbank an.
Syntax
HRESULT SetResultColumn(
[in] LONG ColumnIndex
);
Parameter
[in] ColumnIndex
Ein nullbasierter Index einer Spalte, die in das Resultset eingeschlossen werden soll.
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 SetResultColumn-Methode muss die SetResultColumnCount-Methode aufgerufen werden, um anzugeben, wie viele Spalten im Resultset enthalten sein sollen. Aufrufe der SetResultColumn-Methode schlagen unter den folgenden Bedingungen fehl:
- Die Anzahl der Spalten wurde nicht angegeben.
- SetResultColumn wird häufiger aufgerufen als die Anzahl von Spalten, die durch den Aufruf von SetResultColumnCount angegeben wurde.
-
SetResultColumnCount hat einen vordefinierten Satz von Spalten angegeben. Diese Methode gibt einen vordefinierten Satz von Spalten an, wenn der Parameter cResultColumnCount einer der folgenden Werte ist:
- CV_COLUMN_LOG_DEFAULT
- CV_COLUMN_LOG_FAILED_DEFAULT
- CV_COLUMN_QUEUE_DEFAULT
Die SetResultColumn-Methode muss für jede Spalte aufgerufen werden, die im Resultset benötigt wird. Nach erfolgreichem Abschluss dieser Aufrufe werden die in jedem Aufruf angegebenen Spalten im Resultset enthalten, wenn die OpenView-Methode aufgerufen wird.
Beispiele
HRESULT hr;
LONG nCount;
LONG i;
// Determine the number of columns in the entire database.
// pCertView is a pointer to ICertView.
hr = pCertView->GetColumnCount(FALSE, &nCount);
if (FAILED(hr))
{
printf("Failed GetColumnCount - %x\n", hr);
goto error;
}
hr = pCertView->SetResultColumnCount( nCount );
if (FAILED(hr))
{
printf("Failed SetResultColumnCount - %x\n", hr);
goto error;
}
// Place each column in the view.
for (i = 0; i < nCount; i++)
{
hr = pCertView->SetResultColumn(i);
if (FAILED(hr))
{
printf("Failed SetResultColumn (%d) - %x\n", i, hr );
goto error;
}
}
// Call ICertView::OpenView, and so on.
// ...
error:
{
// Clean up resources, and so on.
}
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 |