ICertAdmin2::D eleteRow-Methode (certadm.h)

Artikel
08/22/2023

Die DeleteRow-Methode löscht eine Zeile oder einen Satz von Zeilen aus einer Datenbanktabelle. Der Aufrufer gibt eine Datenbanktabelle und entweder eine Zeilen-ID oder ein Enddatum an.

Syntax

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

Parameter

[in] strConfig

Stellt eine gültige Konfigurationszeichenfolge für die Zertifizierungsstelle im Format COMPUTERNAME\CANAME dar, wobei COMPUTERNAME der Netzwerkname des Zertifikatdiensteservers und CANAME der allgemeine Name der Zertifizierungsstelle ist, wie er während der Einrichtung der Zertifikatdienste eingegeben wurde. Informationen zum Namen der Konfigurationszeichenfolge finden Sie unter ICertConfig.

WichtigDeleteRow löscht den internen Cache nicht, wenn die Konfigurationszeichenfolge geändert wird. Wenn Sie die Konfigurationszeichenfolge für die Zertifizierungsstelle ändern, müssen Sie ein neues ICertAdmin-Objekt instanziieren und diese Methode erneut mit der neuen Konfigurationszeichenfolge aufrufen.

[in] Flags

Wenn nicht 0, gibt an, ob Date für ein Ablaufdatum oder ein Datum der letzten Änderung gilt.

Dies kann einer der folgenden Werte sein.

Wert	Bedeutung
CDR_EXPIRED	Die zu löschenden Zeilen weisen ein Ablaufdatum auf, das kleiner als Date ist. Dieses Flag kann verwendet werden, wenn Table CVRC_TABLE_REQCERT oder CVRC_TABLE_CRL ist.
CDR_REQUEST_LAST_CHANGED	Die zu löschenden Zeilen gelten für ausstehende oder abgelehnte Anforderungen, und das Datum der letzten Änderung ist kleiner als Date. Dieses Flag kann verwendet werden, wenn Table CVRC_TABLE_REQCERT ist.

[in] Date

Gibt ein Ablaufdatum beim Löschen von Zertifikaten oder Zertifikatsperrlisten und ein Datum der letzten Änderung beim Löschen von Zertifikatanforderungen an.

Wenn dieser Wert nicht 0 ist, muss RowID 0 sein.

[in] Table

Ein LONG-Wert , der die Datenbanktabelle der Zertifikatdienste angibt, aus der die Zeilen gelöscht werden sollen.

Dies kann einer der folgenden Werte sein.

Wert	Bedeutung
CVRC_TABLE_ATTRIBUTES	Die Attributtabelle wird verwendet.
CVRC_TABLE_CRL	Die CRL-Tabelle ( Certificate Revocation List ) wird verwendet.
CVRC_TABLE_EXTENSIONS	Die Erweiterungstabelle wird verwendet.
CVRC_TABLE_REQCERT	Die Tabelle mit ausstehenden Anforderungen, verweigerten Anforderungen, ausgestellten Zertifikaten und widerrufenen Zertifikaten wird verwendet.

[in] RowId

Gibt die ID der zu löschenden Zeile an.

Wenn dieser Wert nicht 0 (null) ist, muss Date 0 (Null) sein.

[out] pcDeleted

Die Anzahl der erfolgreich gelöschten Zeilen.

Rückgabewert

C++

Der Rückgabewert ist ein HRESULT. Der Wert S_OK gibt an, dass die Methode erfolgreich war, und *pcDeleted auf die Anzahl der gelöschten Zeilen festgelegt ist.

VB

Die Anzahl der gelöschten Zeilen.

Hinweise

RowID und Date schließen sich gegenseitig aus. eine und nur eine davon kann ungleich null sein.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	certadm.h (include Certsrv.h)
Bibliothek	Certidl.lib
DLL	Certadm.dll

Weitere Informationen

CCertAdmin

ICertAdmin

ICertAdmin2

Freigeben über