ICertEncodeAltName::SetNameEntry-Methode (certenc.h)

Die SetNameEntry-Methode legt einen Namen auf einen angegebenen Index des Arrays mit alternativen Namen fest.

Bevor Sie diese Methode verwenden, müssen Sie ICertEncodeAltName::Reset aufrufen, damit das Objekt weiß, wie viele Elemente sich im Array befinden.

Syntax

HRESULT SetNameEntry(
  [in] LONG       NameIndex,
  [in] LONG       NameChoice,
  [in] const BSTR strName
);

Parameter

[in] NameIndex

Nullbasierter Index, der den Index des festzulegenden Alternativen Namenseintrags angibt.

Wenn der NameChoice-Parameter CERT_ALT_NAME_OTHER_NAME ist, oder (|) der Indexwert mit EAN_NAMEOBJECTID (definiert als 0x80000000), um die OID festzulegen. Andernfalls wird der Binärwert festgelegt.

[in] NameChoice

Gibt die Namensauswahl an. Die Namensauswahl gibt den Typ des alternativen Namens an, damit er ordnungsgemäß verwendet werden kann. Er muss einen der folgenden Werte aufweisen.

Wert	Bedeutung
CERT_ALT_NAME_DIRECTORY_NAME	Der Name ist ein Verzeichnisname.
CERT_ALT_NAME_DNS_NAME	Der Name ist eine IA5-Zeichenfolge, die einen DNS-Namen (Domain Name System) im Format host.entity.domain angibt.
CERT_ALT_NAME_IP_ADDRESS	Der Name ist eine Oktettzeichenfolge, die eine Internetprotokolladresse darstellt.
CERT_ALT_NAME_REGISTERED_ID	Der Name ist ein registrierter Objektbezeichner (OID).
CERT_ALT_NAME_RFC822_NAME	Der Name ist eine E-Mail-Adresse.
CERT_ALT_NAME_URL	Der Name ist eine IA5-Zeichenfolge, die eine URL im Format Service://HostName/Path enthält.
CERT_ALT_NAME_OTHER_NAME	Der Name besteht aus einem Objektbezeichner (Object Identifier, OID) und einem binären BLOB.

[in] strName

Gibt den alternativen Namen an.

Rückgabewert

VB

Wenn die Methode erfolgreich ist, gibt die Methode S_OK zurück.

Wenn die Methode fehlschlägt, gibt sie einen HRESULT-Wert zurück, der den Fehler angibt. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Nicht unterstützt
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	certenc.h (include Certsrv.h)
Bibliothek	Certidl.lib
DLL	Certenc.dll

Weitere Informationen

ICertEncodeAltName