Remarque
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de vous connecter ou de modifier des répertoires.
L’accès à cette page nécessite une autorisation. Vous pouvez essayer de modifier des répertoires.
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 du bit 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 incluent, mais ne sont pas limitées à celles du tableau suivant. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.
| Retourner le code/la valeur | Descriptif |
|---|---|
|
Le pointeur IObjectId est NULL. |
Remarques
Les algorithmes de chiffrement symétrique suivants sont pris en charge par l’API d’inscription de certificat. Seuls les algorithmes RC2 et RC4 ont des longueurs de clés variables qui peuvent être spécifiées.
| OID | Longueur de clé | Descriptif |
|---|---|---|
| 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 de wrap 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 d’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 fournisseur de chiffrement ou les fournisseurs 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 .
Spécifications
| Requirement | Valeur |
|---|---|
| Client minimum requis | Windows Vista [applications de bureau uniquement] |
| Serveur minimal pris en charge | Windows Server 2008 [applications de bureau uniquement] |
| plateforme cible | Fenêtres |
| Header | certenroll.h |
| DLL | CertEnroll.dll |