Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
Die Initialize-Methode initialisiert das Objekt aus einem symmetrischen Verschlüsselungsalgorithmusobjektbezeichner (OID) und einer optionalen Schlüssellänge.
Syntax
HRESULT Initialize(
[in] IObjectId *pObjectId,
[in] LONG BitCount
);
Die Parameter
[in] pObjectId
Zeiger auf eine IObjectId-Schnittstelle , die das OID darstellt.
[in] BitCount
Eine LONG-Variable , die die Bitlänge des symmetrischen Schlüssels 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ögliche Werte sind die Werte in der folgenden Tabelle, sind jedoch nicht beschränkt. Eine Liste allgemeiner Fehlercodes finden Sie unter "Allgemeine HRESULT-Werte".
| Zurückgeben von Code/Wert | Description |
|---|---|
|
Der IObjectId-Zeiger ist NULL. |
Bemerkungen
Die folgenden symmetrischen Verschlüsselungsalgorithmen werden von der Zertifikatregistrierungs-API unterstützt. Nur die RC2 - und RC4-Algorithmen weisen variable Schlüssellängen auf, die angegeben werden können.
| OID | Schlüssellänge | Description |
|---|---|---|
| XCN_OID_OIWSEC_desCBC1.3.14.3.2.7 | 56 | Die Schlüsselgröße ist der DES CBC-Algorithmus mit 56 Bit. Sie müssen diesen Wert nicht angeben. |
| XCN_OID_RSA_DES_EDE3_CBC1.2.840.113549.3.7 | 168 | Die Schlüsselgröße ist der 3DES-CBC-Algorithmus mit 168 Bit. Sie müssen diesen Wert nicht angeben. |
| XCN_OID_RSA_RC2CBC1.2.840.113549.3.2 | 40 bis 128 | RC4 ist ein Variablenschlüsselalgorithmus. gemeinsame Werte sind 40, 64 und 128 Bit. |
| XCN_OID_RSA_RC41.2.840.113549.3.4 | 40 bis 128 | RC4 ist ein Variablenschlüsselalgorithmus. gemeinsame Werte sind 40, 64 und 128 Bit. |
| XCN_OID_RSA_SMIMEalgCMS3DESwrap1.2.840.113549.1.9.16.3.6 | 168 | Die Schlüsselgröße des MMS Data Encryption Standard (DES)-Schlüsselumbruchalgorithmus beträgt 168 Bit. Sie müssen diesen Wert nicht angeben. |
| XCN_OID_RSA_SMIMEalgCMSRC2wrap1.2.840.113549.1.9.16.3.7 | 128 | Die Schlüsselgröße des MMS RC2-Schlüsselumbruchalgorithmus beträgt 128 Bit. Sie müssen diesen Wert nicht angeben. |
| XCN_OID_NIST_AES128_CBC2.16.840.1.101.3.4.1.2 | 128 | Die Schlüsselgröße wird vom OID impliziert. Sie müssen diesen Wert nicht angeben. |
| XCN_OID_NIST_AES192_CBC2.16.840.1.101.3.4.1.22 | 192 | Die Schlüsselgröße wird vom OID impliziert. Sie müssen diesen Wert nicht angeben. |
| XCN_OID_NIST_AES256_CBC2.16.840.1.101.3.4.1.42 | 256 | Die Schlüsselgröße wird vom OID impliziert. Sie müssen diesen Wert nicht angeben. |
| XCN_OID_NIST_AES128_WRAP2.16.840.1.101.3.4.1.5 | 128 | Die Schlüsselgröße wird vom OID impliziert. Sie müssen diesen Wert nicht angeben. |
| XCN_OID_NIST_AES192_WRAP2.16.840.1.101.3.4.1.25 | 192 | Die Schlüsselgröße wird vom OID impliziert. Sie müssen diesen Wert nicht angeben. |
| XCN_OID_NIST_AES256_WRAP2.16.840.1.101.3.4.1.45 | 256 | Die Schlüsselgröße wird vom OID impliziert. Sie müssen diesen Wert nicht angeben. |
Die Schlüssellänge, die Sie für RC2- und RC4-Algorithmen angeben, muss mit der vom Kryptografieanbieter oder vom Client verwendeten Anbietern konsistent sein. Weitere Informationen finden Sie unter ICspInformation. Sie können die Bitlänge abrufen, indem Sie die BitCount-Eigenschaft aufrufen, und Sie können den Algorithmus OID abrufen, indem Sie die ObjectId-Eigenschaft aufrufen.
Anforderungen
| Anforderung | Wert |
|---|---|
| Mindestens unterstützter Client | Windows Vista [nur Desktop-Apps] |
| Mindestanforderungen für unterstützte Server | Windows Server 2008 [Nur Desktop-Apps] |
| Zielplattform | Fenster |
| Header | certenroll.h |
| DLL | CertEnroll.dll |