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 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

Weitere Informationen

ICertView

ICertView2

ICertView::OpenView

ICertView::SetRestriction

ICertView::SetResultColumnCount