CTL_INFO structure (wincrypt.h)
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 |
|---|---|
|
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
| Requirement | Value |
|---|---|
| Minimum supported client | Windows XP [desktop apps only] |
| Minimum supported server | Windows Server 2003 [desktop apps only] |
| Header | wincrypt.h |