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

Artículo
08/22/2023

El método OpenView abre una vista a una base de datos de Certificate Services y crea una instancia de una instancia de un objeto IEnumCERTVIEWROW .

Sintaxis

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

Parámetros

[out] ppenum

Puntero a un puntero del tipo IEnumCERTVIEWROW .

Valor devuelto

C++

Si el método se realiza correctamente, el método devuelve S_OK.

Si se produce un error en el método, devuelve un valor HRESULT que indica el error. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

VB

El valor devuelto es un objeto IEnumCERTVIEWROW .

Comentarios

Antes de llamar al método OpenView , es necesario establecer una conexión con un servidor de Servicios de certificados llamando primero al método OpenConnection .

El objeto IEnumCERTVIEWROW devuelto por esta llamada representa una secuencia de enumeración de filas cuyo índice interno apunta al principio de la secuencia. Para ver la primera fila de la secuencia, llame a
Método IEnumCERTVIEWROW::Next , que mueve el índice interno a la primera fila.

Para ver un conjunto de columnas no predeterminados o un subconjunto de las filas, llame a SetResultColumnCount, SetResultColumn y SetRestriction después de llamar a OpenConnection y antes de llamar a OpenView.

Ejemplos

// 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 compatible	No se admite ninguno
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	certview.h (incluya Certsrv.h)
Library	Certidl.lib
Archivo DLL	Certadm.dll