Metodo ICertView::SetResultColumnCount (certview.h)

Articolo
03/14/2023

Il metodo SetResultColumnCount specifica il numero massimo di colonne per il set di risultati di una visualizzazione personalizzata del database di Servizi certificati.

Sintassi

HRESULT SetResultColumnCount(
  [in] LONG cResultColumn
);

Parametri

[in] cResultColumn

Specifica il numero massimo di colonne nel set di risultati. Questo parametro può essere impostato su un numero positivo o su zero se si è interessati solo a contare le righe del database di Servizi certificati o a una delle costanti seguenti.

Valore	Significato
CV_COLUMN_LOG_DEFAULT	Il numero di colonne nel set di risultati sarà il numero di colonne nel set di risultati predefinito di Servizi certificati per le richieste risolte. Una richiesta viene risolta se ha generato un certificato rilasciato o una richiesta non riuscita; i certificati revocati vengono considerati risolti.
CV_COLUMN_LOG_FAILED_DEFAULT	Il numero di colonne nel set di risultati sarà il numero di colonne nel set di risultati predefinito di Servizi certificati per le richieste non riuscite.
CV_COLUMN_QUEUE_DEFAULT	Il numero di colonne nel set di risultati sarà il numero di colonne nel set di risultati predefinito di Servizi certificati per le richieste non risolte.

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 SetResultColumnCount , è necessario stabilire una connessione con un server Servizi certificati chiamando prima il metodo OpenConnection . Dopo aver stabilito la connessione, questo metodo può essere chiamato una sola volta e una sola volta per specificare il numero massimo di colonne nel set di risultati.

Se il parametro cResultColumn è impostato su un numero positivo (non una delle costanti predefinite), il metodo SetResultColumn deve essere chiamato per specificare quali colonne includere nel set di risultati. Si noti che SetResultColumn ha esito negativo se viene chiamato più del numero di colonne specificate da SetResultColumnCount.

Esempio

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

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