ICertView：：SetResultColumn 方法 (certview.h)

發行項
02/23/2024

SetResultColumn 方法會指定憑證服務資料庫之自定義檢視結果集的數據行。

語法

HRESULT SetResultColumn(
  [in] LONG ColumnIndex
);

參數

[in] ColumnIndex

要包含在結果集中之數據行之以零起始的索引。

傳回值

VB

如果方法成功，方法會傳回S_OK。

如果方法失敗，它會傳回 HRESULT 值，指出錯誤。如需常見錯誤碼的清單，請參閱一般 HRESULT 值。

備註

呼叫 SetResultColumn 方法之前，必須先呼叫 SetResultColumnCount 方法，以指定結果集中將有多少數據行。在下列情況下， 對 SetResultColumn 方法的呼叫將會失敗：

尚未指定資料行數目。
SetResultColumn 的呼叫次數比呼叫 SetResultColumnCount 所指定的數據行數目還要多。
SetResultColumnCount 指定了一組預先定義的數據行。當 其 cResultColumnCount 參數是下列其中一個值時，這個方法會指定預先定義的一組數據行：
- CV_COLUMN_LOG_DEFAULT
- CV_COLUMN_LOG_FAILED_DEFAULT
- CV_COLUMN_QUEUE_DEFAULT

指定數據行之後，即可使用 SetRestriction 方法的選擇性呼叫來指定數據行的排序和限定限制。

必須針對結果集中需要的每個數據行呼叫 SetResultColumn 方法。成功完成這些呼叫時，呼叫 OpenView 方法時，每個呼叫中指定的數據行都會包含在結果集中。

範例

    HRESULT    hr;
    LONG       nCount;
    LONG       i;

    // Determine the number of columns in the entire database.
    // pCertView is a pointer to ICertView.
    hr = pCertView->GetColumnCount(FALSE, &nCount);
    if (FAILED(hr))
    {
        printf("Failed GetColumnCount - %x\n", hr);
        goto error;
    }
    hr = pCertView->SetResultColumnCount( nCount );
    if (FAILED(hr))
    {
        printf("Failed SetResultColumnCount - %x\n", hr);
        goto error;
    }
    // Place each column in the view.
    for (i = 0; i < nCount; i++)
    {
        hr = pCertView->SetResultColumn(i);
        if (FAILED(hr))
        {
            printf("Failed SetResultColumn (%d) - %x\n", i, hr );
            goto error;
        }
    }
    // Call ICertView::OpenView, and so on.
    // ...

error:
	{
		 // Clean up resources, and so on.
	}

規格需求

需求	值
最低支援的用戶端	都不支援
最低支援的伺服器	Windows Server 2003 [僅限傳統型應用程式]
目標平台	Windows
標頭	certview.h (包含 Certsrv.h)
程式庫	Certidl.lib
Dll	Certadm.dll