Metodo ICertView::OpenView (certview.h)

Articolo
08/22/2023

Il metodo OpenView apre una visualizzazione a un database di Servizi certificati e crea un'istanza di un oggetto IEnumCERTVIEWROW .

Sintassi

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

Parametri

[out] ppenum

Puntatore a un puntatore di tipo IEnumCERTVIEWROW .

Valore restituito

C++

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 dei codici di errore comuni, vedere Valori HRESULT comuni.

VB

Il valore restituito è un oggetto IEnumCERTVIEWROW .

Commenti

Prima di chiamare il metodo OpenView , è necessario stabilire una connessione con un server di Servizi certificati chiamando prima il metodo OpenConnection .

L'oggetto IEnumCERTVIEWROW restituito da questa chiamata rappresenta una sequenza di enumerazione di riga il cui indice interno punta all'inizio della sequenza. Per esaminare la prima riga della sequenza, chiamare
Metodo IEnumCERTVIEWROW::Next , che sposta l'indice interno alla prima riga.

Per visualizzare un set di colonne non predefinito o un subset delle righe, chiamare SetResultColumnCount, SetResultColumn e SetRestriction dopo aver chiamato OpenConnection e prima di chiamare OpenView.

Esempio

// 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();

Requisiti


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