Share via

IX509ExtensionSubjectKeyIdentifier::InitializeEncode-Methode (certenroll.h)

  • Artikel

Die InitializeEncode-Methode initialisiert die Erweiterung aus einem Bytearray, das den Schlüsselbezeichner enthält. Das Bytearray wird durch eine Unicode-codierte Zeichenfolge dargestellt.

Syntax

HRESULT InitializeEncode(
  [in] EncodingType Encoding,
  [in] BSTR         strKeyIdentifier
);

Parameter

[in] Encoding

Ein EncodingType-Enumerationswert , der den Typ der Unicode-Codierung angibt, die auf den strKeyIdentifier-Parameter angewendet wird.

[in] strKeyIdentifier

Eine BSTR-Variable , die den Schlüsselbezeichner enthält.

Rückgabewert

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

Wenn die Funktion fehlschlägt, wird ein HRESULT-Wert zurückgegeben, 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/-wert BESCHREIBUNG
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
 Das Objekt ist bereits initialisiert.

Hinweise

In der Regel sollte der Eingabewert ein SHA-1-Hash des öffentlichen Schlüssels sein, der im Signaturzertifikat der Zertifizierungsstelle enthalten ist. Die -Methode ordnet den Wert dem XCN_OID_SUBJECT_KEY_IDENTIFIER (2.5.29.14)-Objektbezeichner (OID) zu und codiert ihn mithilfe von Distinguished Encoding Rules (DER).

Sie müssen entweder InitializeEncode oder InitializeDecode aufrufen, bevor Sie ein IX509ExtensionSubjectKeyIdentifier-Objekt verwenden können. Die beiden Methoden ergänzen sich. Mit der InitializeEncode-Methode können Sie ein DER-codiertes ASN.1-Erweiterungsobjekt (Abstract Syntax Notation One ) aus Rohdaten erstellen, und mit der InitializeDecode-Methode können Sie die Rohdaten aus einem codierten Objekt initialisieren.

Sie können die folgenden Eigenschaften für diese Erweiterung abrufen:

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

IX509ExtensionSubjectKeyIdentifier