CTL_INFO-Struktur (wincrypt.h)

Artikel
03/06/2024

Die CTL_INFO-Struktur enthält die Informationen, die in einer Zertifikatvertrauensliste (Certificate Trust List , CTL) gespeichert sind.

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;

Member

dwVersion

Die Versionsnummer der CTL. Die derzeit definierten Versionsnummern werden in der folgenden Tabelle angezeigt.

Wert	Bedeutung
CTL_V1	Version 1

SubjectUsage

CTL_USAGE Struktur, die die beabsichtigte Verwendung der Liste als Sequenz von Objektbezeichnern identifiziert. Dies ist identisch mit der Erweiterung "Erweiterte Schlüsselverwendung" .

ListIdentifier

Eine CRYPT_DATA_BLOB-Struktur , die eine Bytezeichenfolge enthält, die die Liste eindeutig identifiziert. Dieser Member wird verwendet, um subjectUsage zu erweitern und gibt die Liste bei Bedarf weiter an.

SequenceNumber

Ein BLOB , das eine monoton steigende Zahl für jede Aktualisierung der CTL enthält.

ThisUpdate

Angabe des Datums und der Uhrzeit der veröffentlichten Zertifikatsperrlisten (Certificate Revocation Lists , CRLs). Wenn die Zeit nach 1950 und vor 2050 liegt, wird sie UTC-Zeit als 8-Byte-Datum/Uhrzeit mit einem 2-stelligen Jahr (d. a. JJMMDDHHMMSS plus 2 Byte) codiert. Andernfalls wird er als 8-Byte-Jahr in Millisekunden mit einem 4-Byte-Jahr generalisiert.

NextUpdate

Angabe des Datums und der Uhrzeit für das nächste verfügbare geplante Update der Zertifikatsperrliste. Wenn die Zeit nach 1950 und vor 2050 liegt, wird sie UTC-Zeit als 8-Byte-Datum/Uhrzeit mit einem 2-stelligen Jahr (d. a. JJMMDDHHMMSS plus 2 Byte) codiert. Andernfalls wird die Zeit generalisiert und als 8-Byte-Datumszeit in Millisekunden mit einem Jahr von 4 Byte codiert.

SubjectAlgorithm

CRYPT_ALGORITHM_IDENTIFIER Struktur, die den Algorithmustyp des SubjectIdentifier in CTL_ENTRY Membern des rgCTLEntry-Memberarrays enthält. Die -Struktur enthält auch zusätzliche Parameter, die vom Algorithmus verwendet werden.

cCTLEntry

Anzahl der Elemente im rgCTLEntry-Memberarray .

rgCTLEntry

Array von CTL_ENTRY Strukturen.

cExtension

Anzahl der Elemente im rgExtension-Array .

rgExtension

Array von CERT_EXTENSION Strukturen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Kopfzeile	wincrypt.h

Weitere Informationen

CERT_EXTENSION

CRYPT_ALGORITHM_IDENTIFIER