Edit

ICertView interface (certview.h)

  • Article

The ICertView interface allows properly authorized clients to create a customized or complete view of the Certificate Services database.

The ICertView interface is used to perform the following tasks:

  • Establish a connection with a Certificate Services server.
  • Obtain a row-enumeration sequence of the rows in the Certificate Services database.
  • Obtain a column-enumeration sequence for the columns of a row in the Certificate Services database.
  • Get the column count and index.
  • Specify sorting and qualifying restrictions for a column.
  • Specify the number of columns and a specific column in a customized view.

In C++, the ICertView interface is instantiated through a call to the COM function CoCreateInstance. If, on the other hand, you are using Visual Basic Scripting Edition, you will need to reference the CertAdm Type library in your project and then instantiate the CCertView object by a call to 'New'. The sample code for the
ICertView::OpenConnection method illustrates the instantiation techniques.

The ICertView interface is defined in Certview.h. When you create your program, however, use Certsrv.h as the include file. Certadm.dll provides the ICertView interface. The type information for this interface is also in Certadml.dll, which is shipped with the Platform Software Development Kit (SDK).

Certificate Services interfaces support both apartment-threading and free-threading models. For better throughput, free threading is recommended.

Inheritance

The ICertView interface inherits from the IDispatch interface. ICertView also has these types of members:

Methods

The ICertView interface has these methods.

 
ICertView::EnumCertViewColumn

Obtains an instance of a column-enumeration sequence for the database schema.
ICertView::GetColumnCount

Retrieves the number of columns in the view of the Certificate Services database.
ICertView::GetColumnIndex

Retrieves the zero-based index of a column.
ICertView::OpenConnection

Establishes a connection with a Certificate Services server.
ICertView::OpenView

Opens a view to a Certificate Services database and instantiates an instance of an IEnumCERTVIEWROW object.
ICertView::SetRestriction

Sets the sorting and qualifying restrictions on a column.
ICertView::SetResultColumn

Specifies a column for the result set of a customized view of the Certificate Services database.
ICertView::SetResultColumnCount

Specifies the maximum number of columns for the result set of a customized view of the Certificate Services database.

Requirements

Requirement Value
Minimum supported client None supported
Minimum supported server Windows Server 2003 [desktop apps only]
Target Platform Windows
Header certview.h (include Certsrv.h)

See also

IDispatch

IEnumCERTVIEWCOLUMN

IEnumCERTVIEWROW