iCertAdmin2：:D eleteRow 方法 (certadm.h)

  • 项目

DeleteRow 方法从数据库表中删除一行或一组行。 调用方指定数据库表和行 ID 或结束日期。

语法

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

参数

[in] strConfig

表示 证书颁发机构 (CA) 的有效配置字符串，格式为 COMPUTERNAME\CANAME，其中 COMPUTERNAME 是证书服务服务器的网络名称，CANAME 是在证书服务设置过程中输入的证书颁发机构的公用名。 有关配置字符串名称的信息，请参阅 ICertConfig。

重要提示：更改 配置字符串时，DeleteRow 不会清除内部缓存。 更改 CA 的配置字符串时，必须实例化新的 ICertAdmin 对象，并使用新的配置字符串再次调用此方法。
 

[in] Flags

如果不是零，则指定 Date 是应用于到期日期还是上次修改日期。

这可以是以下值之一。

值 含义
CDR_EXPIRED
 要删除的行的到期日期小于 Date。 当 表 CVRC_TABLE_REQCERT或CVRC_TABLE_CRL时，可以使用此标志。
CDR_REQUEST_LAST_CHANGED
 要删除的行适用于挂起或拒绝的请求，并且其上次修改日期小于 Date。 CVRC_TABLE_REQCERT Table 时，可以使用此标志。

[in] Date

指定删除证书或 CRL 时的到期日期，以及删除证书请求时的上次修改日期。

如果此值不为零，则 RowID 必须为零。

[in] Table

一个 LONG 值，指定要从中删除行的证书服务数据库表。

这可以是以下值之一。

值 含义
CVRC_TABLE_ATTRIBUTES
 使用 特性 表。
CVRC_TABLE_CRL
 使用 CRL) 表 (证书吊销列表 。
CVRC_TABLE_EXTENSIONS
 使用扩展表。
CVRC_TABLE_REQCERT
 使用挂起的请求、拒绝的请求、颁发的证书和吊销的证书的表。

[in] RowId

指定要删除的行的 ID。

如果此值不为零，则 Date 必须为零。

[out] pcDeleted

成功删除的行数。

返回值

C++

返回值为 HRESULT。 值 S_OK 表示该方法成功，并且 *pcDeleted 设置为已删除的行数。

VB

删除的行数。

注解

RowID 和 Date 是互斥的;其中只有一个可以是非零值。

要求

要求 值
最低受支持的客户端 无受支持的版本
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 certadm.h (包括 Certsrv.h)
Library Certidl.lib
DLL Certadm.dll

另请参阅

CCertAdmin

ICertAdmin

ICertAdmin2