ICertView2 Interface

The ICertView2 interface is one of two interfaces that allow properly authorized clients to create a customized or complete view of the Certificate Services database.

The ICertView2 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 schema 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.
  • Specify which tables are used by subsequent calls to ICertView2 methods (introduced by ICertView2).

In C++, the ICertView2 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 OpenConnection method illustrates the instantiation techniques.

The ICertView2 interface is defined in Certview.h. When you create your program, however, use Certsrv.h as the include file. Certadm.dll provides the ICertView2 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.

Windows 2000:  Certificate Services interfaces do not support free threading.

Inheritance

The ICertView2 interface inherits and extends the ICertView interface.

Methods

The ICertView2 interface inherits from ICertView and IDispatch.

In addition, ICertView2 defines the following methods.

MethodDescription

OpenConnection

Establishes an instance of a column-enumeration sequence for the database schema.

EnumCertViewColumn

Obtains a pointer to IEnumCERTVIEWCOLUMN for schema enumeration.

GetColumnCount

Retrieves the count of columns in the view.

GetColumnIndex

Retrieves the zero-based index of a named column.

SetResultColumnCount

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

SetResultColumn

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

SetRestriction

Sets sorting and qualifying restrictions on a column.

OpenView

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

SetTable

Specifies which Certificate Services database table is used for subsequent calls to the methods of the ICertView2 interface.

 

Requirements

Minimum supported clientNone supported
Minimum supported serverWindows Server 2003
HeaderCertview.h (include Certsrv.h)
LibraryCertidl.lib
DLLCertadm.dll
IIDIID_ICertView2 is defined as d594b282-8851-4b61-9c66-3edadf848863

Send comments about this topic to Microsoft

Build date: 11/16/2009

Tags :


Page view tracker