IX509ExtensionAlternativeNames::InitializeEncode-Methode (certenroll.h)

Die InitializeEncode-Methode initialisiert die Erweiterung aus einer IAlternativeNames-Auflistung .

Syntax

HRESULT InitializeEncode(
  [in] IAlternativeNames *pValue
);

Die Parameter

[in] pValue

Zeiger auf eine IAlternativeNames-Schnittstelle .

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 Methode ordnet die Namensauflistung der XCN_OID_SUBJECT_ALT_NAME2 (2.5.29.17)- Objektbezeichner (OID) zu und codiert sie mithilfe von Distinguished Encoding Rules (DER).

Sie müssen entweder InitializeEncode oder InitializeDecode aufrufen, bevor Sie ein IX509ExtensionAlternativeNames-Objekt verwenden können. Die beiden Methoden ergänzen sich gegenseitig. Mit der InitializeEncode-Methode können Sie ein DER-codiertes abstraktes Syntaxnotation One -Erweiterungsobjekt (ASN.1) aus Rohdaten erstellen, und mit der InitializeDecode-Methode können Sie die Rohdaten aus einem codierten Objekt initialisieren.

Sie können die folgenden Eigenschaften für diese Erweiterung abrufen:

• Die Critical-Eigenschaft gibt an, ob die Erweiterung kritisch ist. Sie können diese Eigenschaft auch angeben.
• Die ObjectId-Eigenschaft ruft das OID ab.
• Die AlternativeNames-Eigenschaft ruft die Auflistung von Namen (die Roherweiterungsdaten) ab.

Anforderungen

Siehe auch

IX509ExtensionAlternativeNames