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

  • Artigo

O método DeleteRow exclui uma linha ou um conjunto de linhas de uma tabela de banco de dados. O chamador especifica uma tabela de banco de dados e uma ID de linha ou uma data final.

Sintaxe

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 uma cadeia de caracteres de configuração válida para a AC (autoridade de certificação ) no formulário COMPUTERNAME\CANAME, em que COMPUTERNAME é o nome de rede do servidor dos Serviços de Certificados e CANAME é o nome comum da autoridade de certificação, conforme inserido durante a instalação dos Serviços de Certificados. Para obter informações sobre o nome da cadeia de caracteres de configuração, consulte ICertConfig.

DeleteRow importante não limpa o cache interno quando a cadeia de caracteres de configuração é alterada. Ao alterar a cadeia de caracteres de configuração para a AC, você deve instanciar um novo objeto ICertAdmin e chamar esse método novamente com a nova cadeia de caracteres de configuração.
 

[in] Flags

Se não for zero, especifica se Data se aplica a uma data de validade ou a data da última modificação.

Esse pode ser um dos valores a seguir.

Valor Significado
CDR_EXPIRED
 As linhas que estão sendo excluídas têm uma data de validade menor que Data. Esse sinalizador pode ser usado quando Table é CVRC_TABLE_REQCERT ou CVRC_TABLE_CRL.
CDR_REQUEST_LAST_CHANGED
 As linhas que estão sendo excluídas são para solicitações pendentes ou negadas, e a data da última modificação é menor que Data. Esse sinalizador pode ser usado quando Table é CVRC_TABLE_REQCERT.

[in] Date

Especifica uma data de validade ao excluir certificados ou CRLs e uma data da última modificação ao excluir solicitações de certificado.

Se esse valor não for zero, RowID deverá ser zero.

[in] Table

Um valor LONG que especifica a tabela de banco de dados dos Serviços de Certificados da qual as linhas devem ser excluídas.

Esse pode ser um dos valores a seguir.

Valor Significado
CVRC_TABLE_ATTRIBUTES
 A tabela de atributos é usada.
CVRC_TABLE_CRL
 A tabela CRL ( lista de revogação de certificados ) é usada.
CVRC_TABLE_EXTENSIONS
 A tabela de extensões é usada.
CVRC_TABLE_REQCERT
 A tabela de solicitações pendentes, solicitações negadas, certificados emitidos e certificados revogados é usada.

[in] RowId

Especifica a ID da linha a ser excluída.

Se esse valor não for zero, Date deverá ser zero.

[out] pcDeleted

O número de linhas excluídas com êxito.

Retornar valor

C++

O valor retornado é um HRESULT. Um valor de S_OK indica que o método foi bem-sucedido e *pcDeleted é definido como o número de linhas excluídas.

VB

O número de linhas excluídas.

Comentários

RowID e Date são mutuamente exclusivos; um e apenas um deles pode ser diferente de zero.

Requisitos

Requisito Valor
Cliente mínimo com suporte Nenhum compatível
Servidor mínimo com suporte Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho certadm.h (inclua Certsrv.h)
Biblioteca Certidl.lib
DLL Certadm.dll

Confira também

CCertAdmin

ICertAdmin

ICertAdmin2