ICspInformation::InitializeFromType-Methode (certenroll.h)

Die InitializeFromType-Methode initialisiert das Objekt vom standardmäßigen kryptografischen Anbieter.

Syntax

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

Die 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 Standardmäßige Kryptografie-API: Next Generation (CNG) verwendet.
• Wenn Sie einen anderen Wert als XCN_PROV_NONE angeben und den Parameter "pAlgorithm " auf NULL festlegen, wird der standardmäßige kryptografische Dienstanbieter (CSP) verwendet.

[in, optional] pAlgorithm

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

[in] MachineContext

Eine VARIANT_BOOL Variable, die angibt, ob der Computer oder der Benutzerkontext verwendet werden soll, um den Standardanbieter für den angegebenen Anbietertyp zu ermitteln. 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, wird ein HRESULT-Wert zurückgegeben, der den Fehler angibt. Mögliche Werte sind die Werte in der folgenden Tabelle, sind jedoch nicht beschränkt. Eine Liste allgemeiner Fehlercodes finden Sie unter "Allgemeine HRESULT-Werte".

Bemerkungen

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
• Valid
• Version

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

Anforderungen

Siehe auch

ICspInformation