CTL_INFO structure

The CTL_INFO structure contains the information stored in a Certificate Trust List (CTL).

Syntax

typedef struct _CTL_INFO {
  DWORD                      dwVersion;
  CTL_USAGE                  SubjectUsage;
  CRYPT_DATA_BLOB            ListIdentifier;
  CRYPT_INTEGER_BLOB         SequenceNumber;
  FILETIME                   ThisUpdate;
  FILETIME                   NextUpdate;
  CRYPT_ALGORITHM_IDENTIFIER SubjectAlgorithm;
  DWORD                      cCTLEntry;
  PCTL_ENTRY                 rgCTLEntry;
  DWORD                      cExtension;
  PCERT_EXTENSION            rgExtension;
} CTL_INFO, *PCTL_INFO;

Members

dwVersion

The CTL's version number. Currently defined version numbers are shown in the following table.

Value Meaning
CTL_V1
Version 1

SubjectUsage

CTL_USAGE structure identifying the intended usage of the list as a sequence of object identifiers. This is the same as in the Enhanced Key Usage extension.

ListIdentifier

A CRYPT_DATA_BLOB structure that includes a byte string that uniquely identifies the list. This member is used to augment the SubjectUsage and further specifies the list when desired.

SequenceNumber

A BLOB that contains a monotonically increasing number for each update of the CTL.

ThisUpdate

Indication of the date and time of the certificate revocation lists (CRLs) published. If the time is after 1950 and before 2050, it is UTC-time encoded as an 8-byte date/time precise to seconds with a 2-digit year (that is, YYMMDDHHMMSS plus 2 bytes). Otherwise, it is generalized-time encoded as an 8-byte year precise to milliseconds with a 4-byte year.

NextUpdate

Indication of the date and time for the CRL's next available scheduled update. If the time is after 1950 and before 2050, it is UTC-time encoded as an 8-byte date/time precise to seconds with a 2-digit year (that is, YYMMDDHHMMSS plus 2 bytes). Otherwise, it is generalized-time encoded as an 8-byte date time precise to milliseconds with a 4-byte year.

SubjectAlgorithm

CRYPT_ALGORITHM_IDENTIFIER structure that contains the algorithm type of the SubjectIdentifier in CTL_ENTRY members of the rgCTLEntry member array. The structure also includes additional parameters used by the algorithm.

cCTLEntry

Number of elements in the rgCTLEntry member array.

rgCTLEntry

Array of CTL_ENTRY structures.

cExtension

Number of elements in the rgExtension array.

rgExtension

Array of CERT_EXTENSION structures.

Requirements

   
Minimum supported client Windows XP [desktop apps only]
Minimum supported server Windows Server 2003 [desktop apps only]
Header wincrypt.h

See Also

CERT_EXTENSION

CRYPT_ALGORITHM_IDENTIFIER

CRYPT_INTEGER_BLOB

CTL_CONTEXT

CTL_ENTRY

CTL_USAGE