Partager via

ISmimeCapability ::Initialize, méthode (certenroll.h)

  • Article

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
CERTSRV_E_PROPERTY_EMPTY
 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

Voir aussi

ISmimeCapabilities

ISmimeCapability

IX509ExtensionSmimeCapabilities