Поделиться через

Метод ICertAdmin2::D eleteRow (certadm.h)

  • Статья

Метод DeleteRow удаляет строку или набор строк из таблицы базы данных. Вызывающий объект указывает таблицу базы данных и идентификатор строки или дату окончания.

Синтаксис

HRESULT DeleteRow(
  [in]  const BSTR strConfig,
  [in]  LONG       Flags,
  [in]  DATE       Date,
  [in]  LONG       Table,
  [in]  LONG       RowId,
  [out] LONG       *pcDeleted
);

Параметры

[in] strConfig

Представляет допустимую строку конфигурации для центра сертификации (ЦС) в формате COMPUTERNAME\CANAME, где COMPUTERNAME — сетевое имя сервера служб сертификации, а CANAME — общее имя центра сертификации, указанное при настройке служб сертификации. Дополнительные сведения об имени строки конфигурации см. в разделе ICertConfig.

Важно!DeleteRow не очищает внутренний кэш при изменении строки конфигурации. При изменении строки конфигурации для ЦС необходимо создать экземпляр нового объекта ICertAdmin и снова вызвать этот метод с новой строкой конфигурации.
 

[in] Flags

Если значение не равно нулю, указывает, применяется ли Дата к дате окончания срока действия или дате последнего изменения.

Это может быть одно из следующих значений.

Значение Значение
CDR_EXPIRED
 Дата окончания срока действия удаляемых строк меньше даты. Этот флаг можно использовать, если таблица CVRC_TABLE_REQCERT или CVRC_TABLE_CRL.
CDR_REQUEST_LAST_CHANGED
 Удаляемые строки предназначены для ожидающих или отклоненных запросов, а дата последнего изменения меньше даты. Этот флаг можно использовать, если таблица CVRC_TABLE_REQCERT.

[in] Date

Указывает дату окончания срока действия при удалении сертификатов или списков отзыва сертификатов и дату последнего изменения при удалении запросов на сертификат.

Если это значение не равно нулю, то RowID должен быть равен нулю.

[in] Table

Значение LONG , указывающее таблицу базы данных служб сертификатов, из которой должны быть удалены строки.

Это может быть одно из следующих значений.

Значение Значение
CVRC_TABLE_ATTRIBUTES
 Используется таблица атрибутов .
CVRC_TABLE_CRL
 Используется таблица списка отзыва сертификатов (CRL).
CVRC_TABLE_EXTENSIONS
 Используется таблица расширений.
CVRC_TABLE_REQCERT
 Используется таблица ожидающих запросов, отклоненных запросов, выданных сертификатов и отозванных сертификатов.

[in] RowId

Указывает идентификатор удаляемой строки.

Если это значение не равно нулю, дата должна быть равна нулю.

[out] pcDeleted

Число успешно удаленных строк.

Возвращаемое значение

C++

Возвращаемое значение — HRESULT. Значение S_OK указывает, что метод выполнен успешно, а для параметра *pcDeleted задано количество удаленных строк.

VB

Число удаленных строк.

Комментарии

RowID и Date являются взаимоисключающими; один и только один из них может быть ненулевым.

Требования

Требование Значение
Минимальная версия клиента Ни одна версия не поддерживается
Минимальная версия сервера Windows Server 2003 [только классические приложения]
Целевая платформа Windows
Header certadm.h (включая Certsrv.h)
Библиотека Certidl.lib
DLL Certadm.dll

См. также раздел

CCertAdmin

ICertAdmin

ICertAdmin2