Метод 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
Header	certview.h (включая Certsrv.h)
Библиотека	Certidl.lib
DLL	Certadm.dll