CTL_INFO

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

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

Members

dwVersion

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

CTL version name	Value
CTL_V1	0

SubjectUsage

The SubjectUsage identifies the intended usage of the list and is represented as a sequence of object identifiers. This is the same as in the Enhanced Key Usage extension.

ListIdentifier

An arbitrary byte string that uniquely identifies the list. This member is used to augment the SubjectUsage and further specifies the list when desired.

SequenceNumber

Used to convey a monotonically increasing number for each update of the CTL.

ThisUpdate

Indicates when a CTL was published. For X509_ASN_ENCODING, if the time is after 1950 and before 2050, it is UTC time encoded as a two-digit year precise to seconds. Otherwise, it is Generalized time encoded as a four-digit year precise to seconds.

NextUpdate

Indicates when the next update of a CTL is scheduled to be available. It can be zero to indicate that there is no next update scheduled. For X509_ASN_ENCODING, if the time is after 1950 and before 2050, it is UTC time encoded as a two-digit year precise to seconds. Otherwise, it is Generalized time encoded as a four-digit year precise to seconds.

SubjectAlgorithm

A structure that contains the algorithm type of the SubjectIdentifier in the array of CTL entries, and any associated additional parameters.

cCTLEntry

The number of elements in rgCTLEntry.

rgCTLEntry

An array of structures, each holding CTL_ENTRY information.

cExtension

The number of elements in rgExtension.

rgExtension

An array of structures, each holding CERT_EXTENSION information.

CTL_INFO

Members

See Also