Méthode ICertAdmin2 ::D eleteRow (certadm.h)

Article
08/22/2023

La méthode DeleteRow supprime une ligne ou un ensemble de lignes d’une table de base de données. L’appelant spécifie une table de base de données et un ID de ligne ou une date de fin.

Syntaxe

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

Paramètres

[in] strConfig

Représente une chaîne de configuration valide pour l’autorité de certification sous la forme COMPUTERNAME\CANAME, où COMPUTERNAME est le nom réseau du serveur des services de certificats et CANAME est le nom commun de l’autorité de certification, tel qu’entré lors de l’installation des services de certificats. Pour plus d’informations sur le nom de la chaîne de configuration, consultez ICertConfig.

Important DeleteRow n’efface pas le cache interne lorsque la chaîne de configuration est modifiée. Lorsque vous modifiez la chaîne de configuration de l’autorité de certification, vous devez instancier un nouvel objet ICertAdmin et appeler à nouveau cette méthode avec la nouvelle chaîne de configuration.

[in] Flags

Si ce n’est pas zéro, spécifie si Date s’applique à une date d’expiration ou à une date de dernière modification.

Il peut s’agir de l’une des valeurs suivantes.

Valeur	Signification
CDR_EXPIRED	Les lignes supprimées ont une date d’expiration inférieure à Date. Cet indicateur peut être utilisé lorsque Table est CVRC_TABLE_REQCERT ou CVRC_TABLE_CRL.
CDR_REQUEST_LAST_CHANGED	Les lignes supprimées sont destinées aux demandes en attente ou refusées, et leur date de dernière modification est inférieure à Date. Cet indicateur peut être utilisé lorsque Table est CVRC_TABLE_REQCERT.

[in] Date

Spécifie une date d’expiration lors de la suppression de certificats ou de listes de révocation de certificats, et une date de dernière modification lors de la suppression des demandes de certificat.

Si cette valeur n’est pas égale à zéro, RowID doit être égal à zéro.

[in] Table

Valeur LONG qui spécifie la table de base de données Des services de certificats à partir de laquelle les lignes doivent être supprimées.

Il peut s’agir de l’une des valeurs suivantes.

Valeur	Signification
CVRC_TABLE_ATTRIBUTES	La table d’attributs est utilisée.
CVRC_TABLE_CRL	La table liste de révocation de certificats (CRL) est utilisée.
CVRC_TABLE_EXTENSIONS	La table d’extensions est utilisée.
CVRC_TABLE_REQCERT	La table des demandes en attente, des demandes refusées, des certificats émis et des certificats révoqués est utilisée.

[in] RowId

Spécifie l’ID de la ligne à supprimer.

Si cette valeur n’est pas égale à zéro, Date doit être égale à zéro.

[out] pcDeleted

Nombre de lignes supprimées avec succès.

Valeur retournée

C++

La valeur de retour est un HRESULT. La valeur S_OK indique que la méthode a réussi, et *pcDeleted est défini sur le nombre de lignes supprimées.

VB

Nombre de lignes à supprimer.

Remarques

RowID et Date s’excluent mutuellement ; un seul d’entre eux peut être différent de zéro.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	certadm.h (include Certsrv.h)
Bibliothèque	Certidl.lib
DLL	Certadm.dll

Voir aussi

CCertAdmin

ICertAdmin

ICertAdmin2

Partager via