Метод ICertView::SetResultColumnCount (certview.h)

Статья
03/14/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.

Примеры

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