ICertView::SetResultColumnCount method (certview.h)

The SetResultColumnCount method specifies the maximum number of columns for the result set of a customized view of the Certificate Services database.

Syntax

HRESULT SetResultColumnCount(
  [in] LONG cResultColumn
);

Parameters

[in] cResultColumn

Specifies the maximum number of columns in the result set. This parameter can be set to a positive number, or to zero if you are only interested in counting the rows of the Certificate Services database, or to one of the following constants.

Return value

VB

If the method fails, it returns an HRESULT value that indicates the error. For a list of common error codes, see Common HRESULT Values.

Remarks

Before calling the SetResultColumnCount method, it is necessary to establish a connection with a Certificate Services server by calling the OpenConnection method first. After the connection is established, this method can be called once, and only once, to specify the maximum number of columns in the result set.

If the cResultColumn parameter is set to a positive number (not one of the predefined constants), the SetResultColumn method must be called to specify which columns to include in the result set. Note that SetResultColumn fails if it is called more than the number of columns specified by SetResultColumnCount.

Examples

HRESULT    hr;
// Specify the result set for logged requests.
// pCertView is pointer to ICertView (which has an Open Connection)
hr = pCertView->SetResultColumnCount(CV_COLUMN_LOG_DEFAULT);
if (S_OK != hr)
    printf("Failed ICertView::SetResultColumnCount - %x\n", hr);
else
{
    // Retrieve data rows by means of ICertView::OpenView.
    // ...
}

Requirements

See also

ICertView

ICertView2

ICertView::OpenConnection

ICertView::SetRestriction

ICertView::SetResultColumn