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

Article
08/22/2023

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

Syntaxe

HRESULT SetResultColumnCount(
  [in] LONG cResultColumn
);

Paramètres

[in] cResultColumn

Spécifie le nombre maximal de colonnes dans le jeu de résultats. Ce paramètre peut être défini sur un nombre positif ou sur zéro si vous souhaitez uniquement compter les lignes de la base de données des services de certificats ou l’une des constantes suivantes.

Valeur	Signification
CV_COLUMN_LOG_DEFAULT	Le nombre de colonnes dans le jeu de résultats correspond au nombre de colonnes dans le jeu de résultats par défaut des services de certificats pour les demandes qui ont été résolues. Une demande est résolue si elle a donné lieu à un certificat émis ou à un échec de demande ; les certificats révoqués sont considérés comme résolus.
CV_COLUMN_LOG_FAILED_DEFAULT	Le nombre de colonnes dans le jeu de résultats correspond au nombre de colonnes dans le jeu de résultats par défaut des services de certificat pour les demandes ayant échoué.
CV_COLUMN_QUEUE_DEFAULT	Le nombre de colonnes dans le jeu de résultats correspond au nombre de colonnes dans le jeu de résultats par défaut des services de certificat pour les demandes qui n’ont pas été résolues.

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 SetResultColumnCount , il est nécessaire d’établir une connexion avec un serveur certificate Services en appelant d’abord la méthode OpenConnection . Une fois la connexion établie, cette méthode peut être appelée une seule fois pour spécifier le nombre maximal de colonnes dans le jeu de résultats.

Si le paramètre cResultColumn est défini sur un nombre positif (pas une des constantes prédéfinies), la méthode SetResultColumn doit être appelée pour spécifier les colonnes à inclure dans le jeu de résultats. Notez que SetResultColumn échoue s’il est appelé plus que le nombre de colonnes spécifié par SetResultColumnCount.

Exemples

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

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 (inclure Certsrv.h)
Bibliothèque	Certidl.lib
DLL	Certadm.dll