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

Artigo
08/22/2023

O método OpenView abre uma exibição para um banco de dados dos Serviços de Certificados e cria uma instância de um objeto IEnumCERTVIEWROW .

Sintaxe

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

Parâmetros

[out] ppenum

Um ponteiro para um ponteiro do tipo IEnumCERTVIEWROW .

Valor retornado

C++

Se o método for bem-sucedido, o método retornará S_OK.

Se o método falhar, ele retornará um valor HRESULT que indica o erro. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

VB

O valor retornado é um objeto IEnumCERTVIEWROW .

Comentários

Antes de chamar o método OpenView , é necessário estabelecer uma conexão com um servidor de Serviços de Certificado chamando o método OpenConnection primeiro.

O objeto IEnumCERTVIEWROW retornado por essa chamada representa uma sequência de enumeração de linha cujo índice interno está apontando para o início da sequência. Para examinar a primeira linha na sequência, chame o
Método IEnumCERTVIEWROW::Next, que move o índice interno para a primeira linha.

Para exibir um conjunto de colunas não padrão ou um subconjunto das linhas, chame SetResultColumnCount, SetResultColumn e SetRestriction depois de chamar OpenConnection e antes de chamar OpenView.

Exemplos

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

Requisitos


Cliente mínimo com suporte	Nenhum compatível
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	certview.h (inclua Certsrv.h)
Biblioteca	Certidl.lib
DLL	Certadm.dll