Метод IX509PrivateKey::get_ProviderType (certenroll.h)

Статья
08/22/2023

Свойство ProviderType указывает или извлекает тип поставщика шифрования, связанного с закрытым ключом. Это свойство включено как для входных, так и для выходных данных.

Это свойство доступно для чтения и записи.

Синтаксис

HRESULT get_ProviderType(
  X509ProviderType *pValue
);

Параметры

pValue

Возвращаемое значение

None

Remarks

Это свойство можно использовать для принудительного использования поставщика по умолчанию для заданного типа поставщика. Например, чтобы использовать поставщик PROV_RSA_SCHANNEL , присвойте этому свойству значение перечисления XCN_PROV_RSA_SCHANNELX509ProviderType и не указывайте значение для свойства ProviderName .

При задании этого свойства следующие свойства автоматически задаются в соответствии с указанным значением ProviderType :

Эти свойства задаются следующим образом:

Если для параметра ProviderType задано значение XCN_PROV_NONE:
- Свойство LegacyCsp имеет значение VARIANT_FALSE.
- Свойство KeySpec имеет значение XCN_AT_NONE.
Если для параметра ProviderType не задано значение XCN_PROV_NONE:
- Свойство LegacyCsp имеет значение VARIANT_TRUE.
- Свойство KeySpec имеет значение XCN_AT_SIGNATURE , если текущее значение XCN_AT_NONE.

Так как установка свойства ProviderType не влияет на ранее указанное значение ProviderName, установка Типа поставщика, несовместимого со свойством ProviderName, приведет к неопределенному поведению, что, скорее всего, приведет к сбою при создании или открытии закрытого ключа. Рекомендуется задавать свойство ProviderType только при попытке принудительного использования поставщика по умолчанию для указанного типа, как описано выше.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	certenroll.h
DLL	CertEnroll.dll

См. также раздел

IX509PrivateKey

Поделиться через