Metodo ICertView::SetResultColumn (certview.h)

Articolo
02/23/2024

Il metodo SetResultColumn specifica una colonna per il set di risultati di una visualizzazione personalizzata del database di Servizi certificati.

Sintassi

HRESULT SetResultColumn(
  [in] LONG ColumnIndex
);

Parametri

[in] ColumnIndex

Indice in base zero di una colonna da includere nel set di risultati.

Valore restituito

VB

Se il metodo ha esito positivo, il metodo restituisce S_OK.

Se il metodo ha esito negativo, restituisce un valore HRESULT che indica l'errore. Per un elenco di codici di errore comuni, vedere Valori HRESULT comuni.

Commenti

Prima di chiamare il metodo SetResultColumn, è necessario chiamare il metodo SetResultColumnCount per specificare il numero di colonne presenti nel set di risultati. Le chiamate al metodo SetResultColumn avranno esito negativo nelle condizioni seguenti:

Il numero di colonne non è stato specificato.
SetResultColumn viene chiamato più volte del numero di colonne specificate dalla chiamata a SetResultColumnCount.
SetResultColumnCount ha specificato un set predefinito di colonne. Questo metodo specifica un set predefinito di colonne quando il parametro cResultColumnCount è uno dei valori seguenti:
- CV_COLUMN_LOG_DEFAULT
- CV_COLUMN_LOG_FAILED_DEFAULT
- CV_COLUMN_QUEUE_DEFAULT

Dopo aver specificato una colonna, è possibile usare una chiamata facoltativa al metodo SetRestriction per specificare restrizioni di ordinamento e qualifica per la colonna.

Il metodo SetResultColumn deve essere chiamato per ogni colonna necessaria nel set di risultati. Al termine di queste chiamate, le colonne specificate in ogni chiamata verranno incluse nel set di risultati quando viene chiamato il metodo OpenView .

Esempio

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

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	certview.h (includere Certsrv.h)
Libreria	Certidl.lib
DLL	Certadm.dll