Méthode ICspAlgorithm ::get_IncrementLength (certenroll.h)
La propriété IncrementLength récupère une valeur, en bits, qui peut être utilisée pour déterminer des longueurs de clé incrémentielles valides pour les algorithmes qui prennent en charge plusieurs tailles de clé. Cette propriété est activée sur le web.
Cette propriété est en lecture seule.
Syntaxe
HRESULT get_IncrementLength(
LONG *pValue
);
Paramètres
pValue
Valeur de retour
None
Remarques
Vous pouvez utiliser la valeur de cette propriété pour déterminer les tailles de clé valides pour les clés générées. Par exemple, si la longueur de clé minimale d’une clé de signature DSA est de 512 bits, que la longueur maximale est de 1 024 bits et que l’incrément est de 64 bits, les tailles de clé valides incluent 512, 576, 640, etc. par incréments de 64 bits jusqu’à 1 024.
Les propriétés DefaultLength, IncrementLength, MaxLength et MinLength peuvent varier selon l’algorithme et le fournisseur. Le tableau suivant répertorie quelques algorithmes pour lesquels plusieurs tailles de clé peuvent être définies. La liste n’est pas inclusive.
| OID de l’algorithme | Fournisseur de chiffrement | Longueur de clé (bits) |
|---|---|---|
| XCN_OID_RSA_RSA(1.2.840.113549.1.1.1) |
Fournisseur de stockage de clés de carte à puce Microsoft Microsoft Base Smart Card Crypto Provider |
Minimum : 1 024 Maximum : 4 096 Valeur par défaut : 1 024 Incrément : 512 |
| XCN_OID_RSA_RSA(1.2.840.113549.1.1.1) |
Fournisseur de stockage de clés logicielles Microsoft Microsoft Base Cryptographic Provider v1.0 Microsoft Enhanced Cryptographic Provider v1.0 Fournisseur de chiffrement RSA et AES microsoft améliorés Fournisseur de chiffrement Schannel Microsoft RSA Microsoft Strong Cryptographic Provider |
Minimum : 384 Maximum : 16 384 Valeur par défaut : 1 024 Incrément : 8 |
| XCN_OID_X957_DSA(1.2.840.10040.4.1) |
Fournisseur de stockage de clés logicielles Microsoft Microsoft Base DSS et fournisseur de chiffrement Diffie-Hellman Microsoft Base DSS Cryptographic Provider Fournisseur de chiffrement Microsoft DH Schannel Microsoft Enhanced DSS et fournisseur de chiffrement Diffie-Hellman |
Minimum : 512 Maximum : 1 024 Valeur par défaut : 1 024 Incrément : 64 |
| XCN_OID_ANSI_X942_DH(1.2.840.10046.2.1) | Diffie-Hellman'algorithme d’échange de clés. |
Minimum : 512 Maximum : 1 024 Valeur par défaut : 1 024 Incrément : 64 |
| XCN_OID_ANSI_X942_DH(1.2.840.10046.2.1) |
Fournisseur de chiffrement Microsoft DH Schannel Microsoft Enhanced DSS et fournisseur de chiffrement Diffie-Hellman |
Minimum : 512 Maximum : 4 096 Valeur par défaut : 1 024 Incrément : 64 |
| XCN_OID_RSA_RC2CBC(1.2.840.113549.3.2) |
Fournisseur de stockage de clés logicielles Microsoft Fournisseur de stockage de clés de carte à puce Microsoft Microsoft Base Smart Card Crypto Provider Fournisseur de chiffrement Microsoft DH Schannel Microsoft Enhanced Cryptographic Provider v1.0 Microsoft Enhanced DSS et fournisseur de chiffrement Diffie-Hellman Fournisseur de chiffrement RSA et AES microsoft améliorés Fournisseur de chiffrement Schannel Microsoft RSA Microsoft Strong Cryptographic Provider |
Minimum : 40 Maximum : 128 Valeur par défaut : 128 Incrément : 8 |
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 |