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

  • Artículo

El método DeleteRow elimina una fila o un conjunto de filas de una tabla de base de datos. El autor de la llamada especifica una tabla de base de datos y un identificador de fila o una fecha de finalización.

Sintaxis

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

Parámetros

[in] strConfig

Representa una cadena de configuración válida para la entidad de certificación (CA) con el formato COMPUTERNAME\CANAME, donde COMPUTERNAME es el nombre de red del servidor de Servicios de certificados y CANAME es el nombre común de la entidad de certificación, tal como se especifica durante la instalación de Servicios de certificados. Para obtener información sobre el nombre de la cadena de configuración, vea ICertConfig.

ImportanteDeleteRow no borra la memoria caché interna cuando se cambia la cadena de configuración. Al cambiar la cadena de configuración de la entidad de certificación, debe crear una instancia de un nuevo objeto ICertAdmin y llamar a este método de nuevo con la nueva cadena de configuración.
 

[in] Flags

Si no es cero, especifica si Date se aplica a una fecha de expiración o a una fecha de última modificación.

Puede ser uno de los valores siguientes.

Valor Significado
CDR_EXPIRED
 Las filas que se eliminan tienen una fecha de expiración menor que Date. Esta marca se puede usar cuando Table se CVRC_TABLE_REQCERT o CVRC_TABLE_CRL.
CDR_REQUEST_LAST_CHANGED
 Las filas que se eliminan son para las solicitudes pendientes o denegadas y su fecha de última modificación es menor que Date. Esta marca se puede usar cuando Table se CVRC_TABLE_REQCERT.

[in] Date

Especifica una fecha de expiración al eliminar certificados o CRL y una fecha de última modificación al eliminar solicitudes de certificado.

Si este valor no es cero, RowID debe ser cero.

[in] Table

Valor LONG que especifica la tabla de base de datos servicios de certificados de la que se van a eliminar las filas.

Puede ser uno de los valores siguientes.

Valor Significado
CVRC_TABLE_ATTRIBUTES
 Se usa la tabla de atributos .
CVRC_TABLE_CRL
 Se usa la tabla de lista de revocación de certificados (CRL).
CVRC_TABLE_EXTENSIONS
 Se usa la tabla de extensiones.
CVRC_TABLE_REQCERT
 Se usa la tabla de solicitudes pendientes, solicitudes denegadas, certificados emitidos y certificados revocados.

[in] RowId

Especifica el identificador de la fila que se va a eliminar.

Si este valor no es cero, Date debe ser cero.

[out] pcDeleted

Número de filas eliminadas correctamente.

Valor devuelto

C++

El valor devuelto es hrESULT. Un valor de S_OK indica que el método se realizó correctamente y *pcDeleted se establece en el número de filas eliminadas.

VB

Número de filas eliminadas.

Comentarios

RowID y Date son mutuamente excluyentes; uno y solo uno de ellos puede ser distinto de cero.

Requisitos

Requisito Value
Cliente mínimo compatible No se admite ninguno
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado certadm.h (incluya Certsrv.h)
Library Certidl.lib
Archivo DLL Certadm.dll

Consulte también

CCertAdmin

ICertAdmin

ICertAdmin2