ICertView::SetResultColumnCount

[This is preliminary documentation and subject to change.]

The SetResultColumnCount method sets the number of columns in a customized view of the Certificate Server database.

[VB] SetResultColumnCount(
  Long cCol
);
 
[JAVA] SetResultColumnCount(
  int cCol
);
 
[C++]HRESULT SetResultColumnCount(
  LONG cCol   // in
);

Parameters

cCol

Value representing how many columns will be in the view's result set. This value must not be negative, with the following exceptions:

cCol is CV_COLUMN_LOG_DEFAULT. In this case the number of columns in the result set will be the number of columns in the Certificate Server's default result set for requests that have been resolved. A request is resolved if it has resulted in an issued certificate or a failed request; revoked certificates are considered resolved.
cCol is CV_COLUMN_LOG_FAILED_DEFAULT. In this case the number of columns in the result set will be the number of columns in the Certificate Server's default result set for requests that have failed.
cCol is CV_COLUMN_QUEUE_DEFAULT. In this case the number of columns in the result set will be the number of columns in the Certificate Server's default result set for requests that have not been resolved.

This function will fail for any other negative values for cCol. If cCol is not negative, the ICertView SetResultColumn method must be called to specify the columns to include in the view's result set.

Return Values

[C++] The return value is an HRESULT. A value of S_OK indicates success.

Remarks

Upon successful completion of this function, the number of columns in the view's result set will be cCol if cCol is positive. If cCol is a valid negative number, the number of columns in the view's result set will correspond to a predefined result set (see the Parameters section for cCol).

The ICertView OpenConnection method must be called prior to calling SetResultColumnCount. This function will fail if called more than once on an open connection

Example

// pCertView is pointer to ICertView (which has an Open Connection)
HRESULT    hr;
// specify the result set for logged requests
hr = pCertView->SetResultColumnCount( CV_COLUMN_LOG_DEFAULT );
if ( S_OK != hr )
    printf("Failed ICertView::SetResultColumnCount - %x\n", hr);
else
    // retrieve data rows via ICertView::OpenView
    …

QuickInfo