IX509PrivateKey::p ut_ProviderType-Methode (certenroll.h)

Die ProviderType-Eigenschaft gibt den Typ des kryptografischen Anbieters an, der dem privaten Schlüssel zugeordnet ist, oder ruft sie ab. Diese Eigenschaft ist sowohl für die Eingabe als auch für die Ausgabe webfähig.

Dies ist eine Eigenschaft mit Lese- und Schreibzugriff.

Syntax

HRESULT put_ProviderType(
  X509ProviderType Value
);

Parameter

Value

Rückgabewert

Keine

Bemerkungen

Sie können diese Eigenschaft verwenden, um die Verwendung des Standardanbieters für einen bestimmten Anbietertyp zu erzwingen. Wenn Sie beispielsweise den PROV_RSA_SCHANNEL-Anbieter verwenden möchten, legen Sie diese Eigenschaft auf den XCN_PROV_RSA_SCHANNELX509ProviderType-Enumerationswert fest, und geben Sie keinen Wert für die ProviderName-Eigenschaft an.

Durch Festlegen dieser Eigenschaft werden die folgenden Eigenschaften automatisch so festgelegt, dass sie mit dem angegebenen ProviderType-Wert konsistent sind:

• KeySpec
• LegacyCsp

Diese Eigenschaften werden wie folgt festgelegt:

• Wenn ProviderType auf XCN_PROV_NONE festgelegt ist:
  • Die LegacyCsp-Eigenschaft ist auf VARIANT_FALSE festgelegt.
  • Die KeySpec-Eigenschaft ist auf XCN_AT_NONE festgelegt.
• Wenn ProviderType nicht auf XCN_PROV_NONE festgelegt ist:
  • Die LegacyCsp-Eigenschaft ist auf VARIANT_TRUE festgelegt.
  • Die KeySpec-Eigenschaft wird auf XCN_AT_SIGNATURE festgelegt, wenn der aktuelle Wert XCN_AT_NONE ist.

Da ein zuvor angegebener ProviderName vom Festlegen der ProviderType-Eigenschaft nicht betroffen ist, führt das Festlegen eines ProviderType , der mit der ProviderName-Eigenschaft inkonsistent ist, zu einem nicht definierten Verhalten, wahrscheinlich zu einem Fehler beim Erstellen oder Öffnen eines privaten Schlüssels. Es wird empfohlen, die ProviderType-Eigenschaft nur festzulegen, wenn Sie versuchen, die Verwendung des Standardanbieters für den angegebenen Typ zu erzwingen, wie oben beschrieben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	certenroll.h
DLL	CertEnroll.dll

Weitere Informationen

IX509PrivateKey