ICertAdmin::RevokeCertificate

The RevokeCertificate method revokes a certificate by a specified date.

[VB] void RevokeCertificate(
  BSTR strConfig,        
  BSTR strSerialNumber,  
  long Reason,           
  DATE Date              
);
 
[JAVA] void RevokeCertificate(
  java.lang.String strConfig,        
  java.lang.String strSerialNumber,  
  int Reason,                        
  double Date                        
);
 
[C++] HRESULT RevokeCertificate(
  BSTR const strConfig,        // in
  BSTR const strSerialNumber,  // in
  LONG Reason,                 // in
  DATE Date                    // in
);
 

Parameters

[VB][JAVA][C++] strConfig

Points to a valid configuration string for the certificate server. See ICertConfig::GetConfig.

[VB][JAVA][C++] strSerialNumber

Specifies the serial number identifying the certificate to be revoked. The string must specify the serial number as an even number of hexadecimal digits. If necessary, a zero may be prepended to the number to achieve an even number of digits. No more than one leading zero may be used.

[VB][JAVA][C++] Reason

Specifies the reason for the revocation. The value can be one of the following values (defined in WinCrypt.h).

Revocation Reason	Value
CRL_REASON_UNSPECIFIED	0
CRL_REASON_KEY_COMPROMISE	1
CRL_REASON_CA_COMPROMISE	2
CRL_REASON_AFFILIATION_CHANGED	3
CRL_REASON_SUPERSEDED	4
CRL_REASON_CESSATION_OF_OPERATION	5
CRL_REASON_CERTIFICATE_HOLD	6

[VB][JAVA][C++] Date

Specifies the date at which the revocation will become effective, in GMT time. The value 0 indicates that the current GMT time should be used.

Return Values

This method does not return a value.

QuickInfo

  Windows NT: Requires version 5.0 or later (or version 4.0 with the Windows NT 4.0 Option Pack).
  Windows: Unsupported.
  Windows CE: Unsupported.
  Header: Declared in certadm.h.
  Import Library: Use certidl.lib.