IAlternativeName::InitializeFromString-Methode (certenroll.h)
Die InitializeFromString-Methode initialisiert das Objekt aus einer Zeichenfolge, die eine E-Mail-Adresse, einen DNS-Namen (Domain Name System), eine URL, einen registrierten Objektbezeichner (OID) oder einen Benutzerprinzipalnamen (UPN) enthält.
Syntax
HRESULT InitializeFromString(
[in] AlternativeNameType Type,
[in] BSTR strValue
);
Parameter
[in] Type
Ein AlternativeNameType-Enumerationswert , der den Typ des Namens identifiziert, der durch die im strValue-Parameter enthaltene Eingabezeichenfolge dargestellt wird. Dies muss einer der folgenden Werte sein.
[in] strValue
Eine BSTR-Variable , die den Namen enthält.
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. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.
Hinweise
Wenn Sie diese Methode verwenden, um einen UPN anzugeben, wird der UPN der OID XCN_OID_NT_PRINCIPAL_NAME (1.3.6.1.4.1.311.20.2.3) zugeordnet und Distinguished Encoding Rules (DER) codiert. Sie können die RawData-Eigenschaft aufrufen, um das codierte Bytearray abzurufen. Sie können die OID abrufen, indem Sie die ObjectId-Eigenschaft aufrufen.
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 wird nicht identifiziert. |
| XCN_CERT_ALT_NAME_OTHER_NAME | Der Name besteht aus einer OID und einem Bytearray. |
| 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. |
Sie können die InitializeFromOtherName-Methode verwenden, um eine OID und eine entsprechende Namenszeichenfolge anzugeben, und Sie können die InitializeFromRawData-Methode verwenden, um eine GUID, eine IP-Adresse oder einen X.500-Verzeichnisnamen anzugeben.
Anforderungen
| 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 |