ICertView：：SetResultColumnCount 方法 (certview.h)

项目
08/22/2023

SetResultColumnCount 方法指定证书服务数据库自定义视图的结果集的最大列数。

语法

HRESULT SetResultColumnCount(
  [in] LONG cResultColumn
);

参数

[in] cResultColumn

指定结果集中的最大列数。此参数可以设置为正数，如果只想对证书服务数据库的行进行计数，则可以将此参数设置为零，或者设置为以下常量之一。

值	含义
CV_COLUMN_LOG_DEFAULT	结果集中的列数将是证书服务针对已解析的请求的默认结果集中的列数。如果请求已导致颁发的证书或请求失败，则会解析该请求;吊销的证书被视为已解决。
CV_COLUMN_LOG_FAILED_DEFAULT	结果集中的列数将是证书服务针对失败请求的默认结果集中的列数。
CV_COLUMN_QUEUE_DEFAULT	结果集中的列数将是证书服务针对尚未解析的请求的默认结果集中的列数。

返回值

VB

如果方法成功，该方法将返回S_OK。

如果方法失败，它将返回一个 指示错误的 HRESULT 值。有关常见错误代码的列表，请参阅通用 HRESULT 值。

注解

在调用 SetResultColumnCount 方法之前，必须首先通过调用 OpenConnection 方法与证书服务服务器建立连接。建立连接后，此方法只能调用一次，以指定结果集中的最大列数。

如果将 cResultColumn 参数设置为正数 (不是) 预定义常量之一，则必须调用 SetResultColumn 方法以指定要包含在结果集中的列。请注意，如果 SetResultColumn 调用的列数超过 SetResultColumnCount 指定的列数，则 SetResultColumn 将失败。

示例

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.
    // ...
}

要求

要求	值
最低受支持的客户端	无受支持的版本
最低受支持的服务器	Windows Server 2003 [仅限桌面应用]
目标平台	Windows
标头	certview.h (包括 Certsrv.h)
Library	Certidl.lib
DLL	Certadm.dll