Freigeben über


IX509PublicKey::Initialize-Methode (certenroll.h)

Die Initialize-Methode initialisiert das Objekt aus einem OID (Public Key Algorithm Object Identifier ) und von Bytearrays, die einen öffentlichen Schlüssel und die zugehörigen Parameter enthalten, falls vorhanden. Die Bytearrays werden durch Unicode-codierte Zeichenfolgen dargestellt.

Syntax

HRESULT Initialize(
  [in] IObjectId    *pObjectId,
  [in] BSTR         strEncodedKey,
  [in] BSTR         strEncodedParameters,
  [in] EncodingType Encoding
);

Die Parameter

[in] pObjectId

Zeiger auf eine IObjectId-Schnittstelle , die den Algorithmus OID darstellt.

[in] strEncodedKey

Eine BSTR-Variable , die den öffentlichen Schlüssel enthält.

[in] strEncodedParameters

Eine BSTR-Variable , die die parameter enthält, die dem öffentlichen Schlüssel zugeordnet sind. Weitere Informationen finden Sie unter der EncodedParameters-Eigenschaft .

[in] Encoding

Ein EncodingType-Enumerationswert , der den Typ der Unicode-Codierung angibt, die auf die in den Parametern strEncodedKey und strEncodedParameters angegebenen Argumente angewendet wird. Der Standardwert ist XCN_CRYPT_STRING_BASE64.

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".

Zurückgeben von Code/Wert Description
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)
Das Objekt wurde bereits initialisiert.

Bemerkungen

Die Initialize-Methode initialisiert die folgenden Eigenschaftswerte:

Anforderungen

Anforderung Wert
Mindestens unterstützter Client Windows Vista [nur Desktop-Apps]
Mindestanforderungen für unterstützte Server Windows Server 2008 [Nur Desktop-Apps]
Zielplattform Fenster
Header certenroll.h
DLL CertEnroll.dll

Siehe auch

IX509PublicKey