Partager via


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