ICspInformation::InitializeFromType-Methode (certenroll.h)

Die InitializeFromType-Methode initialisiert das Objekt vom Kryptografiestandardanbieter.

Syntax

HRESULT InitializeFromType(
  [in]           X509ProviderType Type,
  [in, optional] IObjectId        *pAlgorithm,
  [in]           VARIANT_BOOL     MachineContext
);

Parameter

[in] Type

Ein X509ProviderType-Enumerationswert , der den Anbietertyp definiert.

• Wenn Sie XCN_PROV_NONE angeben und den pAlgorithm-Parameter auf einen anderen Wert als NULL festlegen, wird der CNG-Standardanbieter (Cryptography API: Next Generation) verwendet.
• Wenn Sie einen anderen Wert als XCN_PROV_NONE angeben und den pAlgorithm-Parameter auf NULL festlegen, wird der Standardmäßige Kryptografiedienstanbieter (Legacy Cryptographic Service Provider, CSP) verwendet.

[in, optional] pAlgorithm

Zeiger auf eine IObjectId-Schnittstelle , die eine Algorithmus-OID darstellt. Dieser Parameter ist optional und kann NULL sein. Weitere Informationen finden Sie im Type-Parameter .

[in] MachineContext

Eine VARIANT_BOOL Variable, die angibt, ob der Computer- oder Benutzerkontext verwendet werden soll, um den Standardanbieter für den angegebenen Anbietertyp zu bestimmen. Geben Sie VARIANT_TRUE für den Computer und VARIANT_FALSE für den Benutzer an.

Rückgabewert

Wenn die Funktion erfolgreich ist, gibt die Funktion S_OK zurück.

Wenn die Funktion fehlschlägt, gibt sie einen HRESULT-Wert zurück, der den Fehler angibt. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

Rückgabecode/-wert	BESCHREIBUNG
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	Das Objekt ist bereits initialisiert.

Hinweise

Die InitializeFromType-Methode überprüft den angegebenen Typ und speichert ihn in der Type-Eigenschaft , ruft den Standardanbieter ab und legt die folgenden Eigenschaftswerte für das ICspInformation-Objekt fest:

• CspAlgorithms
• HasHardwareRandomNumberGenerator
• IsHardwareDevice
• IsRemovable
• IsSmartCard
• IsSoftwareDevice
• KeySpec
• LegacyCsp
• MaxKeyContainerNameLength
• Name
• Gültig
• Version

Die -Methode fügt die verfügbaren Algorithmen der ICspAlgorithms-Auflistung hinzu, die von der CspAlgorithms-Eigenschaft zurückgegeben wird. Rufen Sie die InitializeFromName-Methode auf, um das Objekt aus einem CSP-Namen zu initialisieren.

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

ICspInformation