IAlternativeName::InitializeFromOtherName-Methode (certenroll.h)

Artikel
08/22/2023

Die InitializeFromOtherName-Methode initialisiert das Objekt aus einem Objektbezeichner (OID) und den zugeordneten Rohdaten (Bytearray). Diese Methode wird bereitgestellt, um das Feld otherName in der AlternativeNames-Erweiterungsdeklaration für abstrakte Syntax Notation One (ASN.1) zu unterstützen.


----------------------------------------------------------------------
-- AlternativeNames 
-- XCN_OID_SUBJECT_ALT_NAME2 (2.5.29.17)
----------------------------------------------------------------------

AltNames ::= SEQUENCE --#public-- OF GeneralName
GeneralNames ::= AltNames

GeneralName ::= CHOICE 
{
   otherName               [0] IMPLICIT OtherName,
   rfc822Name              [1] IMPLICIT IA5STRING,
   dNSName                 [2] IMPLICIT IA5STRING,
   x400Address             [3] IMPLICIT SeqOfAny,       -- Not supported
   directoryName           [4] EXPLICIT ANY,    
   ediPartyName            [5] IMPLICIT SeqOfAny,
   uniformResourceLocator  [6] IMPLICIT IA5STRING,
   iPAddress               [7] IMPLICIT OCTETSTRING,
   registeredID            [8] IMPLICIT EncodedObjectID -- Not supported
}

OtherName ::= SEQUENCE 
{
   type                    EncodedObjectID,
   value                   [0] EXPLICIT NOCOPYANY 
}

Syntax

HRESULT InitializeFromOtherName(
  [in] IObjectId    *pObjectId,
  [in] EncodingType Encoding,
  [in] BSTR         strRawData,
  [in] VARIANT_BOOL ToBeWrapped
);

Parameter

[in] pObjectId

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

[in] Encoding

Ein EncodingType-Enumerationswert , der den Typ der Unicode-Codierung angibt, die auf den strRawData-Parameter angewendet wird.

[in] strRawData

Eine BSTR-Variable , die den Namen enthält, der der OID zugeordnet ist.

[in] ToBeWrapped

Eine VARIANT_BOOL Variable, die angibt, ob die im strRawData-Parameter enthaltene Eingabezeichenfolge codiert und als Oktettzeichenfolge (Bytearray) gespeichert wird.

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ö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

Sie können diese Funktion verwenden, um ein IAlternativeName-Objekt aus einer OID und einem zugeordneten Zeichenfolgenwert zu initialisieren. Die Zeichenfolge ist Unicode-codiert. Wenn Sie true für den ToBeWrapped-Parameter angeben, wird die Zeichenfolge mithilfe von Distinguished Encoding Rules (DER) codiert. Sie können die OID abrufen, indem Sie die ObjectId-Eigenschaft aufrufen. Sie können die codierte Zeichenfolge oder, wenn ToBeWrapped true ist, das DER-codierte Bytearray abrufen, indem Sie die RawData-Eigenschaft aufrufen, um das codierte Bytearray abzurufen.

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

IAlternativeName

Freigeben über