ISmimeCapability::Initialize-Methode (certenroll.h)
Die Initialize-Methode initialisiert das Objekt aus einem Objektbezeichner des symmetrischen Verschlüsselungsalgorithmus (OID) und einer optionalen Schlüssellänge.
Syntax
HRESULT Initialize(
[in] IObjectId *pObjectId,
[in] LONG BitCount
);
Parameter
[in] pObjectId
Zeiger auf eine IObjectId-Schnittstelle , die die 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ö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 |
|---|---|
|
Der IObjectId-Zeiger ist NULL. |
Hinweise
Die folgenden symmetrischen Verschlüsselungsalgorithmen werden von der Zertifikatregistrierungs-API unterstützt. Nur die Algorithmen RC2 und RC4 weisen variable Schlüssellängen auf, die angegeben werden können.
| OID | Schlüssellänge | BESCHREIBUNG |
|---|---|---|
| XCN_OID_OIWSEC_desCBC1.3.14.3.2.7 | 56 | Die Schlüsselgröße des DES CBC-Algorithmus beträgt 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 des 3DES-CBC-Algorithmus beträgt 168 Bits. Sie müssen diesen Wert nicht angeben. |
| XCN_OID_RSA_RC2CBC1.2.840.113549.3.2 | 40 bis 128 | RC4 ist ein Variablenschlüsselalgorithmus. allgemeine Werte sind 40, 64 und 128 Bit. |
| XCN_OID_RSA_RC41.2.840.113549.3.4 | 40 bis 128 | RC4 ist ein Variablenschlüsselalgorithmus. allgemeine 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 Schlüsselumbruchalgorithmus MMS Data Encryption Standard (DES) 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 von der 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 von der 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 von der 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 von der 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 von der 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 von der 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 Client verwendeten Kryptografieanbieter oder -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 die Algorithmus-OID abrufen, indem Sie die ObjectId-Eigenschaft aufrufen.
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 |