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

代表 證書頒發機構單位 的有效組態字串， (CA) 格式為 COMPUTERNAME\CANAME，其中 COMPUTERNAME 是憑證服務伺服器的網路名稱，而 CANAME 是證書頒發機構單位的一般名稱，如憑證服務設定期間所輸入。 如需設定字串名稱的相關信息，請參閱 ICertConfig。

重要DeleteRow 不會在設定字串變更時清除內部快取。 當您變更 CA 的組態字串時，必須具現化新的 ICertAdmin 物件，並使用新的組態字串再次呼叫此方法。
 

[in] Flags

如果不是零，則指定 Date 適用於到期日或上次修改日期。

這可以是下列其中一個值。

值 意義
CDR_EXPIRED
 刪除的數據列的到期日小於 Date。 當 Table 是CVRC_TABLE_REQCERT或CVRC_TABLE_CRL時，可以使用這個旗標。
CDR_REQUEST_LAST_CHANGED
 刪除的數據列適用於擱置或拒絕的要求，而其上次修改日期小於 Date。 當 Table 是CVRC_TABLE_REQCERT時，可以使用這個旗標。

[in] Date

指定刪除憑證或CRL時的到期日，以及刪除憑證要求時的上次修改日期。

如果此值不是零， 則 RowID 必須是零。

[in] Table

LONG 值，指定要從中刪除數據列的 Certificate Services 資料庫數據表。

這可以是下列其中一個值。

值 意義
CVRC_TABLE_ATTRIBUTES
 會使用 屬性 數據表。
CVRC_TABLE_CRL
 會使用證書 吊銷清單 (CRL) 資料表。
CVRC_TABLE_EXTENSIONS
 會使用延伸模組數據表。
CVRC_TABLE_REQCERT
 會使用擱置的要求、拒絕的要求、發行的憑證和撤銷的憑證數據表。

[in] RowId

指定要刪除之資料列的識別碼。

如果此值不是零，則 Date 必須是零。

[out] pcDeleted

已成功刪除的數據列數目。

傳回值

C++

傳回值為 HRESULT。 S_OK 的值表示方法成功，而 *pcDeleted 會設定為已刪除的數據列數目。

VB

刪除的資料列數目。

備註

RowID 和 Date 互斥;其中一個和其中一個可以是非零。

規格需求

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

另請參閱

CCertAdmin

ICertAdmin

ICertAdmin2