Méthode ICspStatuses ::get_ItemByProvider (certenroll.h)

La propriété ItemByProvider récupère un objet ICspStatus qui porte le même nom que le fournisseur spécifié lors de l’entrée, mais identifie un algorithme qui prend en charge une autre utilisation de clé prévue.

Cette propriété est en lecture seule.

Syntaxe

HRESULT get_ItemByProvider(
  ICspStatus *pCspStatus,
  ICspStatus **ppValue
);

Paramètres

pCspStatus

ppValue

Valeur de retour

None

Remarques

La propriété ItemByProvider récupère l’objet ICspStatus qui correspond au nom du fournisseur d’entrée, mais qui est associé à une autre valeur d’énumération X509KeySpec . Par exemple, si le fournisseur d’entrée a une valeur KeySpec de XCN_AT_KEYEXCHANGE, la propriété ItemByProvider tente de trouver un objet ICspStatus pour le même fournisseur, mais avec une valeur KeySpec de XCN_AT_SIGNATURE.

Étant donné que la propriété KeySpec n’est associée qu’aux fournisseurs hérités, si vous spécifiez des fournisseurs CNG (Cryptography API : Next Generation), la propriété ItemByProvider renvoie le même objet ICspStatus que celui entré.

Pour utiliser cette propriété pour itérer au sein de la collection, procédez comme suit :

• Récupérez une collection ICspStatuses en appelant la méthode GetCspStatuses ou la propriété CspStatuses sur l’interface IX509CertificateRequestPkcs10 .
• Appelez la propriété ItemByIndex pour itérer dans la collection.
• Pour chaque élément ICspStatus récupéré qui contient le fournisseur qui vous intéresse, appelez ItemByProvider.

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

ICspStatuses