ICertView interface (certview.h)
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) |