ICspStatuses::get_ItemByProvider method (certenroll.h)

The ItemByProvider property retrieves an ICspStatus object that has the same name as the provider specified on input but identifies an algorithm that supports a different intended key use.

This property is read-only.


HRESULT get_ItemByProvider(
  ICspStatus *pCspStatus,
  ICspStatus **ppValue




Return value



The ItemByProvider property retrieves the ICspStatus object that matches the name of the input provider but is associated with a different X509KeySpec enumeration value. For example, if the input provider has a KeySpec value of XCN_AT_KEYEXCHANGE, the ItemByProvider property attempts to find an ICspStatus object for the same provider but with a KeySpec value of XCN_AT_SIGNATURE.

Because the KeySpec property is only associated with legacy providers, if you specify a Cryptography API: Next Generation (CNG) providers, the ItemByProvider property returns the same ICspStatus object as that entered.

To use this property to iterate through the collection, perform the following steps:


Minimum supported client Windows Vista [desktop apps only]
Minimum supported server Windows Server 2008 [desktop apps only]
Target Platform Windows
Header certenroll.h
DLL CertEnroll.dll

See also