Metodo ICertAdmin2::D eleteRow (certadm.h)

Articolo
08/22/2023

Il metodo DeleteRow elimina una riga o un set di righe da una tabella di database. Il chiamante specifica una tabella di database e un ID riga o una data di fine.

Sintassi

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

Parametri

[in] strConfig

Rappresenta una stringa di configurazione valida per l'autorità di certificazione (CA) nel formato NOMECOMPUTER\CANAME, dove COMPUTERNAME è il nome di rete del server servizi certificati e CANAME è il nome comune dell'autorità di certificazione, come immesso durante l'installazione di Servizi certificati. Per informazioni sul nome della stringa di configurazione, vedere ICertConfig.

ImportanteDeleteRow non cancella la cache interna quando viene modificata la stringa di configurazione. Quando si modifica la stringa di configurazione per la CA, è necessario creare un'istanza di un nuovo oggetto ICertAdmin e chiamare di nuovo questo metodo con la nuova stringa di configurazione.

[in] Flags

Se non è zero, specifica se Date si applica a una data di scadenza o a una data dell'ultima modifica.

Può trattarsi di uno dei valori seguenti.

Valore	Significato
CDR_EXPIRED	Le righe eliminate hanno una data di scadenza inferiore a Data. Questo flag può essere usato quando Table è CVRC_TABLE_REQCERT o CVRC_TABLE_CRL.
CDR_REQUEST_LAST_CHANGED	Le righe eliminate sono relative a richieste in sospeso o negate e la data dell'ultima modifica è minore di Date. Questo flag può essere usato quando Table è CVRC_TABLE_REQCERT.

[in] Date

Specifica una data di scadenza quando si eliminano certificati o CRL e una data dell'ultima modifica durante l'eliminazione delle richieste di certificato.

Se questo valore non è zero, RowID deve essere zero.

[in] Table

Valore LONG che specifica la tabella di database di Servizi certificati da cui eliminare le righe.

Può trattarsi di uno dei valori seguenti.

Valore	Significato
CVRC_TABLE_ATTRIBUTES	Viene utilizzata la tabella degli attributi .
CVRC_TABLE_CRL	Viene utilizzata la tabella dell'elenco di revoche di certificati (CRL).
CVRC_TABLE_EXTENSIONS	Viene utilizzata la tabella delle estensioni.
CVRC_TABLE_REQCERT	Viene usata la tabella delle richieste in sospeso, delle richieste negate, dei certificati emessi e dei certificati revocati.

[in] RowId

Specifica l'ID della riga da eliminare.

Se questo valore non è zero, date deve essere zero.

[out] pcDeleted

Numero di righe eliminate.

Valore restituito

C++

Il valore restituito è HRESULT. Un valore di S_OK indica che il metodo è riuscito e *pcDeleted è impostato sul numero di righe eliminate.

VB

Il numero di righe eliminate.

Commenti

RowID e Date si escludono a vicenda; uno e solo uno di essi può essere diverso da zero.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	certadm.h (include Certsrv.h)
Libreria	Certidl.lib
DLL	Certadm.dll

Vedi anche

CCertAdmin

ICertAdmin

ICertAdmin2

Condividi tramite