IX509AttributeOSVersion::InitializeEncode-Methode (certenroll.h)

  • Artikel

Die InitializeEncode-Methode initialisiert das Attribut anhand von Betriebssystemversionsinformationen.

Syntax

HRESULT InitializeEncode(
  [in, optional] BSTR strOSVersion
);

Parameter

[in, optional] strOSVersion

Eine BSTR-Variable , die die Versionsinformationen enthält. Das Format der Zeichenfolge ist major.minor.build.platform. Dieser Parameter ist optional. Wenn Sie keine Zeichenfolge angeben, ruft diese Methode die GetVersionEx-Funktion auf.

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 (Object Identifier, OID) für dieses Attribut ist XCN_OID_OS_VERSION (1.3.6.1.4.1.311.13.2.3). Weitere Informationen finden Sie unter CERTENROLL_OBJECTID.

Sie müssen entweder InitializeEncode oder InitializeDecode aufrufen, bevor Sie ein IX509AttributeOSVersion-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 OSVersion-Eigenschaft aufrufen, um die Rohdaten abzurufen.

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

IX509AttributeOSVersion