ICertView：：SetRestriction 方法 (certview.h)

项目
02/23/2024

SetRestriction 方法设置对列的排序和限定限制。

语法

HRESULT SetRestriction(
  [in] LONG          ColumnIndex,
  [in] LONG          SeekOperator,
  [in] LONG          SortOrder,
  [in] const VARIANT *pvarValue
);

参数

[in] ColumnIndex

视图的有效列索引号或预定义的列说明符。如果 ColumnIndex 参数不是负数，则此值表示接收限制的列的从零开始的索引。

如果 ColumnIndex 参数为负数，则忽略所有其他参数，并且此参数必须是以下值之一。

值	含义
CV_COLUMN_LOG_DEFAULT	将视图限制为已解析的请求。如果请求已导致颁发的证书或请求失败，则会解析该请求;吊销的证书被视为已解决。
CV_COLUMN_LOG_FAILED_DEFAULT	将视图限制为失败的请求。
CV_COLUMN_QUEUE_DEFAULT	将视图限制为尚未解决的请求;如果请求已导致证书颁发或请求失败，则它不是视图的一部分。

[in] SeekOperator

指定列的数据查询限定符的逻辑运算符。此参数与 pvarValue 参数一起使用，用于定义数据查询限定符。此参数必须设置为以下值之一。

值	含义
CVR_SEEK_EQ	等于
CVR_SEEK_LE	小于或等于
CVR_SEEK_LT	小于
CVR_SEEK_GE	大于等于
CVR_SEEK_GT	大于

[in] SortOrder

指定列的排序顺序。具有零个或一个限制的索引列可以包含CVR_SORT_ASCEND或CVR_SORT_DESCEND的排序顺序。非索引列或具有两个或更多限制的列必须使用CVR_SORT_NONE。

值	含义
CVR_SORT_ASCEND	升序
CVR_SORT_DESCEND	降序
CVR_SORT_NONE	无排序顺序

[in] pvarValue

指定应用于此列的数据查询限定符。此参数与 SeekOperator 参数一起确定哪些数据将返回到“证书服务”视图。

返回值

VB

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

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

注解

ICertView 对象维护一个限制数组，允许每列包含任意数量的限制。建立列限制后，对 ICertView：：OpenView 方法的调用将检索数据，并将每个列的限制用作数据库查询的一部分。

在调用 SetRestriction 方法之前，必须通过调用 ICertView：：OpenConnection 方法与证书服务服务器建立连接。

示例

    // This example restricts the data
    // to rows that have RequestIDs greater than five.
    // pCertView is a pointer to ICertView.
    HRESULT    hr;
    VARIANT    varRest;
    LONG       nIndex;
    BSTR       bstrCol = NULL;

    // Use one column in the result set.
    hr = pCertView->SetResultColumnCount(1);
    if (FAILED(hr))
    {
        printf("Failed SetResultColumnCount - %x\n", hr);
        goto error;
    }
    // Determine the column index for RequestID column.
    bstrCol = SysAllocString(TEXT("RequestID"));
    hr = pCertView->GetColumnIndex(FALSE, bstrCol, &nIndex);
    if (FAILED(hr))
    {
        printf("Failed GetColumnIndex - %x\n", hr);
        goto error;
    }
    // Place this column into the result set.
    pCertView->SetResultColumn(nIndex);
    // Set a restriction on this column.
    VariantInit(&varRest);
    varRest.vt = VT_I4;
    varRest.lVal = 5;
    // Restrict view to requests with ID greater than 5.
    hr = pCertView->SetRestriction(nIndex,
                                   CVR_SEEK_GT,
                                   CVR_SORT_NONE,
                                   &varRest);
    if (S_OK != hr)
        printf("Failed ICertView::SetRestriction - %x\n", hr);
    else
	{
        // Call OpenView, process rows, release resources, and so on.
        // ...
	}
error:
    // Done processing, clear resources.
    VariantClear(&varRest);
    if (NULL != bstrCol)
        SysFreeString(bstrCol);

要求

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