ICertView：：SetRestriction 方法 (certview.h)

發行項
02/26/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)
程式庫	Certidl.lib
Dll	Certadm.dll