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

COMPUTERNAME\CANAME 形式の証明機関 (CA) の有効な構成文字列を表します。COMPUTERNAME は証明書サービス サーバーのネットワーク名、CANAME は証明書サービスのセットアップ時に入力された証明機関の共通名です。 構成文字列名の詳細については、「 ICertConfig」を参照してください。

重要 DeleteRow は、構成文字列が変更されたときに内部キャッシュをクリアしません。 CA の構成文字列を変更する場合は、新しい ICertAdmin オブジェクトをインスタンス化し、新しい構成文字列を使用してこのメソッドを再度呼び出す必要があります。
 

[in] Flags

0 以外の場合は、 Date が有効期限または最終変更日に適用されるかどうかを指定します。

これには、次のいずれかの値を指定できます。

値 意味
CDR_EXPIRED
 削除される行の有効期限が Date 未満です。 このフラグは、 Table がCVRC_TABLE_REQCERTまたはCVRC_TABLE_CRLの場合に使用できます。
CDR_REQUEST_LAST_CHANGED
 削除される行は保留中または拒否された要求用であり、最後に変更された日付が Date 未満です。 このフラグは、 Table がCVRC_TABLE_REQCERTされている場合に使用できます。

[in] Date

証明書または CRL を削除する際の有効期限と、証明書要求を削除するときに最後に変更された日付を指定します。

この値が 0 でない場合、 RowID は 0 である必要があります。

[in] Table

行の削除元となる Certificate Services データベース テーブルを指定する LONG 値。

これには、次のいずれかの値を指定できます。

値 意味
CVRC_TABLE_ATTRIBUTES
 属性テーブルが使用されます。
CVRC_TABLE_CRL
 証明書失効リスト (CRL) テーブルが使用されます。
CVRC_TABLE_EXTENSIONS
 拡張機能テーブルが使用されます。
CVRC_TABLE_REQCERT
 保留中の要求、拒否された要求、発行された証明書、および失効した証明書のテーブルが使用されます。

[in] RowId

削除する行の ID を指定します。

この値が 0 でない場合、 Date は 0 である必要があります。

[out] pcDeleted

正常に削除された行の数。

戻り値

C++

戻り値は HRESULT です。 S_OK の値は、メソッドが成功したことを示し、*pcDeleted は削除された行数に設定されます。

VB

削除された行数。

注釈

RowID と Date は相互に排他的です。1 つで、そのうちの 1 つだけを 0 以外にすることができます。

要件

要件 値
サポートされている最小のクライアント サポートなし
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー certadm.h (Certsrv.h を含む)
Library Certidl.lib
[DLL] Certadm.dll

こちらもご覧ください

CCertAdmin

ICertAdmin

ICertAdmin2