IPolicyQualifier-Schnittstelle (certenroll.h)

Artikel
08/22/2023

Die IPolicyQualifier-Schnittstelle stellt einen Qualifizierer dar, der einer Zertifikatrichtlinie zugeordnet werden kann. Die folgende Syntax zeigt die ASN.1-Strukturen ( Abstract Syntax Notation One ), die Zertifikatrichtlinien und die zugehörigen Qualifizierer definieren. Der Wert wird mithilfe von Distinguished Encoding Rules (DER) codiert und in die Zertifikatanforderung mit dem Richtlinienobjekt eingeschlossen, das er qualifiziert.


----------------------------------------------------------------------
-- CertificatePolicies
-- XCN_OID_CERT_POLICIES (2.5.29.32)
----------------------------------------------------------------------

CertificatePolicies ::= SEQUENCE OF PolicyInformation

PolicyInformation ::= SEQUENCE 
{
   policyIdentifier    EncodedObjectID,
   policyQualifiers    PolicyQualifiers OPTIONAL
}

PolicyQualifiers ::=  SEQUENCE OF PolicyQualifierInfo

PolicyQualifierInfo ::= SEQUENCE 
{
   policyQualifierId   EncodedObjectID,
   qualifier           NOCOPYANY OPTIONAL
}

----------------------------------------------------------------------
-- UserNotice
-- XCN_OID_PKIX_POLICY_QUALIFIER_USERNOTICE (1.3.6.1.5.5.7.2.2)
----------------------------------------------------------------------

UserNotice ::= SEQUENCE 
{
   noticeRef,      -- Not supported
   explicitText    -- Not supported
}

----------------------------------------------------------------------
-- Certification Practice Statement (CPS) qualifier
-- XCN_OID_PKIX_POLICY_QUALIFIER_CPS (1.3.6.1.5.5.7.2.1)
----------------------------------------------------------------------

CpsURLs ::= SEQUENCE OF SEQUENCE 
{
   url                 IA5String,
   digestAlgorithmId,  -- Not supported
   digest              -- Not supported
}

Richtlinienqualifizierer können verwendet werden, wenn ein Objektbezeichner (Object Identifier, OID) nicht ausreicht, um eine Richtlinie vollständig zu identifizieren. Qualifizierer werden mithilfe der IPolicyQualifier-Schnittstelle definiert und können einer Richtlinie zugeordnet werden, indem der IPolicyQualifiers-Auflistung , die aus einem ICertificatePolicy-Objekt abgerufen wird, Qualifizierer hinzugefügt werden. Eine Windows-Zertifizierungsstelle unterstützt die folgenden Qualifizierer.

Wert	BESCHREIBUNG
XCN_OID_PKIX_POLICY_QUALIFIER_USERNOTICE(1.3.6.1.5.5.7.2.2)	Enthält einen Hinweis, der jedem Benutzer angezeigt werden soll, der auf das Zertifikat angewiesen ist.
XCN_OID_PKIX_POLICY_QUALIFIER_CPS(1.3.6.1.5.5.7.2.1)	Gibt einen Zeiger auf einen URI an, der die von der Zertifizierungsstelle definierte Zertifizierungspraxis-Anweisung (CPS) enthält.

Es sei denn, ein Benutzerhinweis in der Kette dupliziert einen anderen, sollten alle Hinweise im Zertifikatpfad der vertrauenden Seite angezeigt werden. Um Duplizierungen zu minimieren, sollte dieser Qualifizierer nur in den Zertifikaten der Endentität und der Zertifizierungsstelle vorhanden sein, die für andere Organisationen ausgestellt wurden. Der Benutzerhinweis verfügt über zwei optionale Felder, noticeRef und explicitText, die nicht unterstützt werden. Richtlinien und Richtlinienqualifizierer werden in IX509ExtensionCertificatePolicies-Objekten verwendet.

Vererbung

Die IPolicyQualifier-Schnittstelle erbt von der IDispatch-Schnittstelle . IPolicyQualifier verfügt auch über folgende Membertypen:

Methoden

Die IPolicyQualifier-Schnittstelle verfügt über diese Methoden.


IPolicyQualifier::get_ObjectId Ruft den Objektbezeichner (Object Identifier, OID) für den Qualifizierer ab.
IPolicyQualifier::get_Qualifier Ruft eine Zeichenfolge ab, die den Qualifizierer enthält, der zum Initialisieren des Objekts verwendet wird.
IPolicyQualifier::get_RawData Ruft das Distinguished Encoding Rules(DER)-codierte Qualifiziererobjekt ab.
IPolicyQualifier::get_Type Ruft den Qualifizierertyp ab.
IPolicyQualifier::InitializeEncode Initialisiert das -Objekt aus einer Zeichenfolge und einem Wert, der den Qualifizierertyp identifiziert.

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	certenroll.h

Weitere Informationen

CertEnroll-Schnittstellen

IDispatch

IPolicyQualifier

IX509ExtensionCertificatePolicies