ICertView interface

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 is extended by the ICertView2 interface.

Members

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

Methods

The ICertView interface has these methods.

MethodDescription
EnumCertViewColumn

Obtains a pointer to IEnumCERTVIEWCOLUMN for schema enumeration.

(Inherited from ICertViewCCertView)
GetColumnCount

Retrieves the count of columns in the view.

(Inherited from ICertViewCCertView)
GetColumnIndex

Retrieves the zero-based index of a named column.

(Inherited from ICertViewCCertView)
OpenConnection

Establishes a connection with a Certificate Services server.

(Inherited from ICertViewCCertView)
OpenView

Opens a view to a Certificate Services database and obtains a pointer to IEnumCERTVIEWROW.

(Inherited from ICertViewCCertView)
SetRestriction

Sets sorting and qualifying restrictions on a column.

(Inherited from ICertViewCCertView)
SetResultColumn

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

(Inherited from ICertViewCCertView)
SetResultColumnCount

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

(Inherited from ICertViewCCertView)

 

Requirements

Minimum supported client

None supported

Minimum supported server

Windows Server 2003 [desktop apps only]

Header

Certview.h (include Certsrv.h)

Library

Certidl.lib

DLL

Certadm.dll

IID

IID_ICertView is defined as c3fac344-1e84-11d1-9bd6-00c04fb683fa

See also

IEnumCERTVIEWCOLUMN
IEnumCERTVIEWROW

 

 

Community Additions

ADD
Show:
© 2014 Microsoft