IPolicyQualifier::InitializeEncode-Methode (certenroll.h)

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 ist nicht angegeben.
PolicyQualifierTypeUrl	Der Qualifizierer ist eine URL, die auf eine Zertifizierungspraxiserklärung (Certification Practice Statement, 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 für jeden Benutzer angezeigt wird, der auf dem Zertifikat basiert. Der Benutzerhinweis identifiziert die zulässigen Verwendungen des Zertifikats.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion S_OKzurück.

Wenn die Funktion fehlschlägt, wird ein HRESULT- Wert zurückgegeben, der den Fehler angibt. Mögliche Werte sind die Werte in der folgenden Tabelle, sind jedoch nicht beschränkt. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

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

Bemerkungen

Wenn Sie PolicyQualifierTypeUrl- im Parameter Type angeben, diese Methode ordnet die im strQualifier Parameter eingegebene Zeichenfolge dem XCN_OID_PKIX_POLICY_QUALIFIER_CPS (1.3.6.1.5.5.7.2.1) Objektbezeichner (OID) zu und codiert sie mithilfe von Distinguished Encoding Rules (DER). Die URL wird als abstrakte Syntaxnotation One (ASN.1) IA5-Zeichenfolge codiert.

Wenn Sie PolicyQualifierTypeUserNotice im Parameter Type angeben, ordnet diese Methode die im strQualifier Parameter eingegebene ZEICHENFOLGE dem 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 ein OID ab, das angibt, ob der Qualifizierer ein CPS oder ein Benutzerhinweis ist.
• Die Qualifizierer- eigenschaft ruft die für den strQualifier Parameter der InitializeEncode--Methode angegebene Zeichenfolge ab.
• Die RawData--Eigenschaft ruft den DER-codierten Qualifizierer ab.
• Die Type-Eigenschaft ruft einen Wert der PolicyQualifierType Enumeration ab, die den Qualifizierertyp angibt.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows Vista [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2008 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	certenroll.h
DLL-	CertEnroll.dll

Siehe auch

IPolicyQualifier-