IX509AttributeOSVersion::InitializeEncode-Methode (certenroll.h)
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 |