ISmimeCapability ::Initialize, méthode (certenroll.h)
La méthode Initialize initialise l’objet à partir d’un identificateur d’objet d’algorithme de chiffrement symétrique (OID) et d’une longueur de clé facultative.
Syntaxe
HRESULT Initialize(
[in] IObjectId *pObjectId,
[in] LONG BitCount
);
Paramètres
[in] pObjectId
Pointeur vers une interface IObjectId qui représente l’OID.
[in] BitCount
Variable LONG qui contient la longueur de bits de la clé symétrique.
Valeur retournée
Si la fonction réussit, la fonction retourne S_OK.
Si la fonction échoue, elle retourne une valeur HRESULT qui indique l’erreur. Les valeurs possibles sont notamment celles figurant dans le tableau suivant. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.
| Code/valeur de retour | Description |
|---|---|
|
Le pointeur IObjectId a la valeur NULL. |
Remarques
Les algorithmes de chiffrement symétrique suivants sont pris en charge par l’API d’inscription de certificats. Seuls les algorithmes RC2 et RC4 ont des longueurs de clé variables qui peuvent être spécifiées.
| OID | Longueur de clé | Description |
|---|---|---|
| XCN_OID_OIWSEC_desCBC1.3.14.3.2.7 | 56 | La taille de clé est de l’algorithme DES CBC est de 56 bits. Vous n’avez pas besoin de spécifier cette valeur. |
| XCN_OID_RSA_DES_EDE3_CBC1.2.840.113549.3.7 | 168 | La taille de clé est de l’algorithme CBC 3DES est de 168 bits. Vous n’avez pas besoin de spécifier cette valeur. |
| XCN_OID_RSA_RC2CBC1.2.840.113549.3.2 | 40 à 128 | RC4 est un algorithme de clé variable. Les valeurs courantes sont 40, 64 et 128 bits. |
| XCN_OID_RSA_RC41.2.840.113549.3.4 | 40 à 128 | RC4 est un algorithme de clé variable. Les valeurs courantes sont 40, 64 et 128 bits. |
| XCN_OID_RSA_SMIMEalgCMS3DESwrap1.2.840.113549.1.9.16.3.6 | 168 | La taille de clé de l’algorithme d’habillage de clé MMS Data Encryption Standard (DES) est de 168 bits. Vous n’avez pas besoin de spécifier cette valeur. |
| XCN_OID_RSA_SMIMEalgCMSRC2wrap1.2.840.113549.1.9.16.3.7 | 128 | La taille de clé de l’algorithme de habillage de clé MMS RC2 est de 128 bits. Vous n’avez pas besoin de spécifier cette valeur. |
| XCN_OID_NIST_AES128_CBC2.16.840.1.101.3.4.1.2 | 128 | La taille de clé est implicite par l’OID. Vous n’avez pas besoin de spécifier cette valeur. |
| XCN_OID_NIST_AES192_CBC2.16.840.1.101.3.4.1.22 | 192 | La taille de clé est implicite par l’OID. Vous n’avez pas besoin de spécifier cette valeur. |
| XCN_OID_NIST_AES256_CBC2.16.840.1.101.3.4.1.42 | 256 | La taille de clé est implicite par l’OID. Vous n’avez pas besoin de spécifier cette valeur. |
| XCN_OID_NIST_AES128_WRAP2.16.840.1.101.3.4.1.5 | 128 | La taille de clé est implicite par l’OID. Vous n’avez pas besoin de spécifier cette valeur. |
| XCN_OID_NIST_AES192_WRAP2.16.840.1.101.3.4.1.25 | 192 | La taille de clé est implicite par l’OID. Vous n’avez pas besoin de spécifier cette valeur. |
| XCN_OID_NIST_AES256_WRAP2.16.840.1.101.3.4.1.45 | 256 | La taille de clé est implicite par l’OID. Vous n’avez pas besoin de spécifier cette valeur. |
La longueur de clé que vous spécifiez pour les algorithmes RC2 et RC4 doit être cohérente avec celle prise en charge par le ou les fournisseurs de chiffrement utilisés par le client. Pour plus d’informations, consultez ICspInformation. Vous pouvez récupérer la longueur du bit en appelant la propriété BitCount , et vous pouvez récupérer l’algorithme OID en appelant la propriété ObjectId .
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | certenroll.h |
| DLL | CertEnroll.dll |