IAlternativeName::InitializeFromRawData-Methode (certenroll.h)

Artikel
08/22/2023

Die InitializeFromRawData-Methode initialisiert das Objekt aus einer DSA-GUID (Digital Signature Algorithm), einem X.500-Verzeichnisnamen oder einer IP-Adresse (Internet Protocol), die in einem Distinguished Encoding Rules (DER)-codierten Bytearray enthalten ist.

Syntax

HRESULT InitializeFromRawData(
  [in] AlternativeNameType Type,
  [in] EncodingType        Encoding,
  [in] BSTR                strRawData
);

Parameter

[in] Type

Ein AlternativeNameType-Enumerationswert , der den Von der Eingabezeichenfolge dargestellten Namenstyp angibt. Dies muss einer der folgenden Werte sein.

Wert	Bedeutung
XCN_CERT_ALT_NAME_DIRECTORY_NAME	Der Name ist ein X.500-Verzeichnisname.
XCN_CERT_ALT_NAME_IP_ADDRESS	Der Name ist eine IP-Adresse.
XCN_CERT_ALT_NAME_GUID	Der Name ist eine GUID.

[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 die DER-codierten Daten enthält.

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	Beschreibung
HRESULT_FROM_WIN32(ERROR_ALREADY_INITIALIZED)	Das Objekt ist bereits initialisiert.

Hinweise

Die Rohdaten sind ein Bytearray, das mithilfe von Distinguished Encoding Rules (DER) codiert wurde. Sie müssen das Bytearray als Unicode-codierte Zeichenfolge angeben.

Wenn Sie diese Methode verwenden, um eine DSA-GUID (XCN_CERT_ALT_NAME_GUID) anzugeben, wird die GUID dem XCN_OID_NTDS_REPLICATION (1.3.6.1.4.1.311.25.1)- Objektbezeichner (OID) zugeordnet und als Oktettzeichenfolge (Bytearray) codiert. Sie können die OID abrufen, indem Sie die ObjectId-Eigenschaft aufrufen. Sie können die RawData-Eigenschaft aufrufen, um das codierte Bytearray abzurufen.

Wenn Sie diese Methode verwenden, um einen der folgenden Namenstypen anzugeben, gibt die Methode E_INVALIDARG zurück.

Wert	BESCHREIBUNG
XCN_CERT_ALT_NAME_UNKNOWN	Der Namenstyp ist nicht identifiziert.
XCN_CERT_ALT_NAME_RFC822_NAME	Der Name ist eine E-Mail-Adresse.
XCN_CERT_ALT_NAME_DNS_NAME	Der Name ist ein DNS-Name.
XCN_CERT_ALT_NAME_URL	Der Name ist eine URL.
XCN_CERT_ALT_NAME_REGISTERED_ID	Der Name ist eine registrierte OID.
XCN_CERT_ALT_NAME_USER_PRINCIPLE_NAME	Der Name ist ein Benutzerprinzipalname (User Principal Name , UPN).
XCN_CERT_ALT_NAME_OTHER_NAME	Der Name besteht aus einer OID und einem Bytearray.

Sie können die InitializeFromOtherName-Methode verwenden, um eine OID und eine entsprechende Namenszeichenfolge anzugeben, und Sie können die InitializeFromString-Methode verwenden, um eine E-Mail-Adresse, einen DNS-Namen, eine URL, eine registrierte OID oder einen Benutzerprinzipalnamen (UPN) anzugeben.

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