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

Voir aussi

DefaultLength

ICspAlgorithm