CERT_KEY_ATTRIBUTES_INFO-Struktur (wincrypt.h)

Die CERT_KEY_ATTRIBUTES_INFO-Struktur enthält optionale zusätzliche Informationen zum öffentlichen Schlüssel, der zertifiziert wird. Sie kann einen Schlüsselbezeichner, einen Hinweis auf die beabsichtigte Verwendung dieses Schlüssels oder einen Hinweis auf die Nutzungsdauer des entsprechenden privaten Schlüssels enthalten.

CryptDecodeObject erstellt eine instance dieser Struktur, wenn es für das Value-Element einer CERT_EXTENSION-Struktur ausgeführt wird, wobei das pszObjId-Element der Struktur auf szOID_KEY_ATTRIBUTES festgelegt ist.

Ein instance dieser Struktur kann als Eingabe für CryptEncodeObject verwendet werden, um eine geeignete CERT_EXTENSION zu erstellen.

Syntax

typedef struct _CERT_KEY_ATTRIBUTES_INFO {
  CRYPT_DATA_BLOB            KeyId;
  CRYPT_BIT_BLOB             IntendedKeyUsage;
  PCERT_PRIVATE_KEY_VALIDITY pPrivateKeyUsagePeriod;
} CERT_KEY_ATTRIBUTES_INFO, *PCERT_KEY_ATTRIBUTES_INFO;

Member

KeyId

Eine CRYPT_DATA_BLOB-Struktur mit einem eindeutigen Bezeichner eines Schlüssels.

IntendedKeyUsage

CRYPT_BIT_BLOB mit diesem pbData-Member , der den beabsichtigten Zweck des Schlüssels angibt. Eine Liste der Bitwerte finden Sie im RestrictedKeyUsage-Element der CERT_KEY_USAGE_RESTRICTION_INFO-Struktur .

Dieses Element kann verwendet werden, um den richtigen Schlüssel oder das richtige Zertifikat eines Benutzers zu finden, der über mehrere Schlüssel oder Zertifikate verfügt. Die Angabe der Verwendung ist nur ein Beratungsfeld und bedeutet nicht, dass die Verwendung des Schlüssels auf den angegebenen Zweck beschränkt ist. Die Liste der beabsichtigten Verwendungen ist nicht notwendigerweise allumfassend, und das Feld kann weggelassen werden. Wenn ein Schlüssel auf eine bestimmte Verwendung beschränkt werden soll, muss eine CERT_KEY_USAGE_RESTRICTION_INFO-Erweiterung verwendet werden.

pPrivateKeyUsagePeriod

Ein Zeiger auf eine CERT_PRIVATE_KEY_VALIDITY Struktur, die den Zeitraum der Verwendung des privaten Schlüssels angibt, der dem zertifizierten öffentlichen Schlüssel entspricht. Dieser Member ist optional und kann auf NULL festgelegt werden.

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

CERT_PRIVATE_KEY_VALIDITY

CRYPT_BIT_BLOB

CRYPT_INTEGER_BLOB

CryptDecodeObject