Export (0) Print
Expand All
Expand Minimize

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.

ValueMeaning
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

 

 

Community Additions

ADD
Show:
© 2014 Microsoft