Méthode ICertView ::SetResultColumn (certview.h)

Article
08/22/2023

La méthode SetResultColumn spécifie une colonne pour le jeu de résultats d’une vue personnalisée de la base de données Des services de certificats.

Syntaxe

HRESULT SetResultColumn(
  [in] LONG ColumnIndex
);

Paramètres

[in] ColumnIndex

Index de base zéro d’une colonne à inclure dans le jeu de résultats.

Valeur retournée

VB

Si la méthode réussit, la méthode retourne S_OK.

Si la méthode échoue, elle retourne une valeur HRESULT qui indique l’erreur. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.

Remarques

Avant d’appeler la méthode SetResultColumn , la méthode SetResultColumnCount doit être appelée pour spécifier le nombre de colonnes dans le jeu de résultats. Les appels à la méthode SetResultColumn échouent dans les conditions suivantes :

Le nombre de colonnes n’a pas été spécifié.
SetResultColumn est appelé plus de fois que le nombre de colonnes spécifié par l’appel à SetResultColumnCount.
SetResultColumnCount a spécifié un ensemble prédéfini de colonnes. Cette méthode spécifie un ensemble prédéfini de colonnes lorsque son paramètre cResultColumnCount est l’une des valeurs suivantes :
- CV_COLUMN_LOG_DEFAULT
- CV_COLUMN_LOG_FAILED_DEFAULT
- CV_COLUMN_QUEUE_DEFAULT

Une fois qu’une colonne est spécifiée, un appel facultatif à la méthode SetRestriction peut être utilisé pour spécifier des restrictions de tri et de qualification pour la colonne.

La méthode SetResultColumn doit être appelée pour chaque colonne nécessaire dans le jeu de résultats. Une fois ces appels terminés, les colonnes spécifiées dans chaque appel sont incluses dans le jeu de résultats lorsque la méthode OpenView est appelée.

Exemples

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	certview.h (include Certsrv.h)
Bibliothèque	Certidl.lib
DLL	Certadm.dll