IX509PrivateKey ::get_ProviderType, méthode (certenroll.h)

  • Article

La propriété ProviderType spécifie ou récupère le type de fournisseur de chiffrement associé à la clé privée. Cette propriété est activée sur le web pour l’entrée et la sortie.

Cette propriété est en lecture/écriture.

Syntaxe

HRESULT get_ProviderType(
  X509ProviderType *pValue
);

Paramètres

pValue

Valeur de retour

None

Remarques

Vous pouvez utiliser cette propriété pour forcer l’utilisation du fournisseur par défaut pour un type de fournisseur donné. Par exemple, pour utiliser le fournisseur de PROV_RSA_SCHANNEL , définissez cette propriété sur la valeur d’énumération XCN_PROV_RSA_SCHANNELX509ProviderType et ne spécifiez pas de valeur pour la propriété ProviderName .

La définition de cette propriété définit automatiquement les propriétés suivantes pour qu’elles soient cohérentes avec la valeur ProviderType spécifiée :

Ces propriétés sont définies de la manière suivante :
  • Si ProviderType est défini sur XCN_PROV_NONE :
    • La propriété LegacyCsp a la valeur VARIANT_FALSE.
    • La propriété KeySpec a la valeur XCN_AT_NONE.
  • Si ProviderType n’est pas défini sur XCN_PROV_NONE :
    • La propriété LegacyCsp a la valeur VARIANT_TRUE.
    • La propriété KeySpec a la valeur XCN_AT_SIGNATURE si la valeur actuelle est XCN_AT_NONE.
Étant donné qu’un ProviderName précédemment spécifié n’est pas affecté par la définition de la propriété ProviderType , la définition d’un ProviderType qui est incohérent avec la propriété ProviderName entraîne un comportement non défini, probablement un échec lors de la création ou de l’ouverture d’une clé privée. Nous vous recommandons de définir la propriété ProviderType uniquement lorsque vous tentez de forcer l’utilisation du fournisseur par défaut pour le type spécifié, comme indiqué ci-dessus.

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

IX509PrivateKey