Share via

IX509AttributeRenewalCertificate::InitializeEncode-Methode (certenroll.h)

  • Artikel

Die InitializeEncode-Methode initialisiert das Attribut mithilfe des zu erneuernden Zertifikats. Das Zertifikat muss mithilfe von Distinguished Encoding Rules (DER) codiert werden.

Syntax

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

Parameter

[in] Encoding

Ein EncodingType-Enumerationswert , der den Typ der Unicode-Codierung angibt, die auf das im strCert-Parameter enthaltene Zertifikat angewendet wird.

[in] strCert

Eine BSTR-Variable , die das DER-codierte Zertifikat enthält.

Ab Windows 7 und Windows Server 2008 R2 können Sie anstelle eines codierten Zertifikats einen Fingerabdruck oder eine Seriennummer angeben. Dadurch durchsucht die Funktion die entsprechenden lokalen Speicher nach dem übereinstimmenden Zertifikat. Berücksichtigen Sie dabei Folgendes:

  • Der BSTR muss eine gerade Anzahl von Hexadezimalstellen sein.
  • Leerzeichen zwischen Hexadezimalpaaren werden ignoriert.
  • Der Encoding-Parameter muss auf XCN_CRYPT_STRING_HEXRAW festgelegt werden.
  • Wenn ein privater Schlüssel benötigt wird, werden nur die persönlichen Speicher und die Anforderungsspeicher durchsucht.
  • Wenn kein privater Schlüssel benötigt wird, werden auch die Stamm- und Zwischenspeicher der Zertifizierungsstellen durchsucht.

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. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

Hinweise

Der Objektbezeichner (OID) für dieses Attribut ist XCN_OID_RENEWAL_CERTIFICATE (1.3.6.1.4.1.311.13.1). Weitere Informationen finden Sie unter CERTENROLL_OBJECTID.

Sie müssen entweder InitializeEncode oder InitializeDecode aufrufen, bevor Sie ein IX509AttributeRenewalCertificate-Objekt verwenden können. Die beiden Methoden ergänzen sich. Mit der InitializeEncode-Methode können Sie eine codierte ASN.1-Struktur ( Abstract Syntax Notation One ) aus Rohdaten erstellen, und mit der InitializeDecode-Methode können Sie Rohdaten aus einer codierten ASN.1-Struktur initialisieren. Sie können die RenewalCertificate-Eigenschaft aufrufen, um die Rohdaten abzurufen.

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
DLL CertEnroll.dll

Weitere Informationen

IX509AttributeRenewalCertificate