Freigeben über

ICspInformation::InitializeFromType-Methode (certenroll.h)

  • Artikel

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:

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