ICertView::OpenView

[This is preliminary documentation and subject to change.]

The OpenView method opens a view to a Certificate Server database and obtains a pointer to the IEnumCERTVIEWROW interface.

[VB] CEnumCERTVIEWROW OpenView();
 
[JAVA] CEnumCERTVIEWROW OpenView();
 
[C++] HRESULT OpenView(
  IEnumCERTVIEWROW **ppenum  // out
);
 

Parameters

[C++] ppenum
Pointer to a pointer of IEnumCERTVIEWROW type.

Return Values

[VB][JAVA] The return value is a IEnumCERTVIEWROW object.

[C++] The return value is an HRESULT. A value of S_OK indicates success.

Remarks

The IEnumCERTVIEWROW object is used to enumerate the data rows in the view. The IEnumCERTVIEWROW object will be positioned to the beginning of the Certificate Server view's rows, so that a call to the object's Next method will reference the first row.

Before the ICertView OpenView method is called, it is necessary to call the ICertView OpenConnection method.

Example

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

QuickInfo

  Windows NT: Requires version 5.0 or later.
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in certview.h.
  Import Library: Use certidl.lib.

See Also

IEnumCERTVIEWROW Interface, ICertView::OpenConnection