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

Article
08/22/2023

La méthode OpenView ouvre une vue sur une base de données Des services de certificats et instancie un instance d’un objet IEnumCERTVIEWROW.

Syntaxe

HRESULT OpenView(
  [out] IEnumCERTVIEWROW **ppenum
);

Paramètres

[out] ppenum

Pointeur vers un pointeur de type IEnumCERTVIEWROW .

Valeur retournée

C++

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.

VB

La valeur de retour est un objet IEnumCERTVIEWROW .

Remarques

Avant d’appeler la méthode OpenView , il est nécessaire d’établir une connexion avec un serveur des services de certificats en appelant d’abord la méthode OpenConnection .

L’objet IEnumCERTVIEWROW retourné par cet appel représente une séquence d’énumération de lignes dont l’index interne pointe vers le début de la séquence. Pour examiner la première ligne de la séquence, appelez le
Méthode IEnumCERTVIEWROW::Next , qui déplace l’index interne vers la première ligne.

Pour afficher un ensemble de colonnes non par défaut ou un sous-ensemble des lignes, appelez SetResultColumnCount, SetResultColumn et SetRestriction après avoir appelé OpenConnection et avant d’appeler OpenView.

Exemples

// pCertView is previously instantiated pointer to ICertView.
IEnumCERTVIEWROW * pEnumRow = NULL;
HRESULT    hr;

hr = pCertView->OpenView(&pEnumRow);
if (S_OK != hr)
    printf("Failed ICertView::OpenView - %x\n", hr);
else
    // use pEnumRow as needed, to enumerate data rows
    // ...
// Done processing, free resources.
if (NULL != pEnumRow)
    pEnumRow->Release();

Configuration requise


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