Skip to content

Latest commit

 

History

History
93 lines (80 loc) · 4.79 KB

nf-certenroll-ix509privatekey-put_providertype.md

File metadata and controls

93 lines (80 loc) · 4.79 KB
Raw
UID title description helpviewer_keywords old-location tech.root ms.assetid ms.date ms.keywords req.header req.include-header req.target-type req.target-min-winverclnt req.target-min-winversvr req.kmdf-ver req.umdf-ver req.ddi-compliance req.unicode-ansi req.idl req.max-support req.namespace req.assembly req.type-library req.lib req.dll req.irql targetos req.typenames req.redist ms.custom f1_keywords dev_langs topic_type api_type api_location api_name
NF:certenroll.IX509PrivateKey.put_ProviderType
IX509PrivateKey::put_ProviderType (certenroll.h)
Specifies or retrieves the type of cryptographic provider associated with the private key. (Put)
IX509PrivateKey interface [Security]
ProviderType property
IX509PrivateKey.ProviderType
IX509PrivateKey.put_ProviderType
IX509PrivateKey::ProviderType
IX509PrivateKey::get_ProviderType
IX509PrivateKey::put_ProviderType
ProviderType property [Security]
ProviderType property [Security]
IX509PrivateKey interface
certenroll/IX509PrivateKey::ProviderType
certenroll/IX509PrivateKey::get_ProviderType
certenroll/IX509PrivateKey::put_ProviderType
put_ProviderType
security.ix509privatekey_providertype
security\ix509privatekey_providertype.htm
security
5f4d2e29-8c02-4d9c-a3a6-15c222650c3e
12/05/2018
IX509PrivateKey interface [Security],ProviderType property, IX509PrivateKey.ProviderType, IX509PrivateKey.put_ProviderType, IX509PrivateKey::ProviderType, IX509PrivateKey::get_ProviderType, IX509PrivateKey::put_ProviderType, ProviderType property [Security], ProviderType property [Security],IX509PrivateKey interface, certenroll/IX509PrivateKey::ProviderType, certenroll/IX509PrivateKey::get_ProviderType, certenroll/IX509PrivateKey::put_ProviderType, put_ProviderType, security.ix509privatekey_providertype
certenroll.h
Windows
Windows Vista [desktop apps only]
Windows Server 2008 [desktop apps only]
CertEnroll.dll
Windows
19H1
IX509PrivateKey::put_ProviderType
certenroll/IX509PrivateKey::put_ProviderType
c++
APIRef
kbSyntax
COM
CertEnroll.dll
IX509PrivateKey.ProviderType
IX509PrivateKey.get_ProviderType
IX509PrivateKey.put_ProviderType

IX509PrivateKey::put_ProviderType

-description

The ProviderType property specifies or retrieves the type of cryptographic provider associated with the private key. This property is web enabled for both input and output.

This property is read/write.

-parameters

-remarks

You can use this property to force the use of the default provider for a given provider type. For example, to use the PROV_RSA_SCHANNEL provider, set this property to the XCN_PROV_RSA_SCHANNELX509ProviderType enumeration value and do not specify a value for the ProviderName property.

Setting this property automatically sets the following properties to be consistent with the specified ProviderType value:

These properties are set in the following manner:
  • If the ProviderType is set to XCN_PROV_NONE:
    • The LegacyCsp property is set to VARIANT_FALSE.
    • The KeySpec property is set to XCN_AT_NONE.
  • If the ProviderType is not set to XCN_PROV_NONE:
    • The LegacyCsp property is set to VARIANT_TRUE.
    • The KeySpec property is set to XCN_AT_SIGNATURE if the current value is XCN_AT_NONE.
Because a previously specified ProviderName is not affected by setting the ProviderType property, setting a ProviderType that is inconsistent with the ProviderName property will result in undefined behavior, likely a failure when creating or opening a private key. We recommend that you set the ProviderType property only when attempting to force the use of the default provider for the specified type as discussed above.

-see-also

IX509PrivateKey