IPolicyQualifier::InitializeEncode-Methode (certenroll.h)

Artikel
08/22/2023

Die InitializeEncode-Methode initialisiert das Objekt aus einer Zeichenfolge und einem Wert, der den Qualifizierertyp identifiziert.

Syntax

HRESULT InitializeEncode(
  [in] BSTR                strQualifier,
  [in] PolicyQualifierType Type
);

Parameter

[in] strQualifier

Eine BSTR-Variable , die den Qualifizierer enthält.

[in] Type

Ein PolicyQualifierType-Enumerationswert , der den Typ des Qualifizierers angibt, der auf eine Zertifikatrichtlinie angewendet wird. Dies kann einer der folgenden Werte sein.

Wert	Bedeutung
PolicyQualifierTypeUnknown	Der Qualifizierertyp wird nicht angegeben.
PolicyQualifierTypeUrl	Der Qualifizierer ist eine URL, die auf eine Zertifizierungspraxiserklärung (CPS) verweist, die von der Zertifizierungsstelle definiert wurde, um die Richtlinien zu beschreiben, unter denen das Zertifikat ausgestellt wurde, und die Zwecke, für die das Zertifikat verwendet werden kann.
PolicyQualifierTypeUserNotice	Der Qualifizierer ist eine Text-Anweisung, die von der Anwendung jedem Benutzer angezeigt wird, der sich auf das Zertifikat verlässt. Der Benutzerhinweis identifiziert die zulässige Verwendung des Zertifikats.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion S_OK zurück.

Wenn die Funktion fehlschlägt, gibt sie einen HRESULT-Wert zurück, der den Fehler angibt. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

Rückgabecode	Beschreibung
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	Das Objekt ist bereits initialisiert.

Hinweise

Wenn Sie PolicyQualifierTypeUrl im Parameter Type angeben, ordnet diese Methode die im strQualifier-Parameter eingegebene Zeichenfolge dem Objektbezeichner (1.3.6.1.5.5.7.2.1) des Objektbezeichners (OID) XCN_OID_PKIX_POLICY_QUALIFIER_CPS (1.3.6.1.5.7.2.1) zu und codiert sie mithilfe von Distinguished Encoding Rules (DER). Die URL ist als IA5-Zeichenfolge der abstrakten Syntax Notation 1 (ASN.1) codiert.

Wenn Sie PolicyQualifierTypeUserNotice im Type-Parameter angeben, ordnet diese Methode die im strQualifier-Parameter eingegebene Zeichenfolge dem OID XCN_OID_PKIX_POLICY_QUALIFIER_USERNOTICE (1.3.6.1.5.5.7.2.2) zu und codiert sie mithilfe von DER.

Sie können die folgenden Eigenschaften für dieses Objekt abrufen:

Die ObjectId-Eigenschaft ruft eine OID ab, die angibt, ob der Qualifizierer ein CPS oder ein Benutzerhinweis ist.
Die Qualifier-Eigenschaft ruft die Zeichenfolge ab, die für den strQualifier-Parameter der InitializeEncode-Methode angegeben ist.
Die RawData-Eigenschaft ruft den DER-codierten Qualifizierer ab.
Die Type-Eigenschaft ruft einen Wert der PolicyQualifierType-Enumeration ab, der den Qualifizierertyp angibt.

Anforderungen

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

Weitere Informationen

IPolicyQualifier

Freigeben über