ICertEncodeAltName::GetNameChoice-Methode (certenc.h)

  • Artikel
  • 2 Minuten Lesedauer

Die GetNameChoice-Methode gibt die Namensauswahl bei einem angegebenen Index eines alternativen Namenarrays zurück.

Syntax

HRESULT GetNameChoice(
  [in]  LONG NameIndex,
  [out] LONG *pNameChoice
);

Parameter

[in] NameIndex

Gibt den Index des alternativen Namenseintrags an. Der erste Eintrag befindet sich bei Index Null.

[out] pNameChoice

Ein Zeiger auf eine LONG , die den Namensauswahlsauszeichner empfängt.

Rückgabewert

C++

Wenn die Methode erfolgreich ist, gibt die Methode S_OK zurück, und der pNameChoice-Parameter verweist auf einen Wert, der den Typ des alternativen Namens angibt. Dies ist eine der folgenden Werte.

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.

VB

Der Rückgabewert ist die Namensauswahl im angegebenen Index. Die Namensauswahl gibt den Typ des alternativen Namens an, damit er ordnungsgemäß verwendet werden kann. Es muss eine der folgenden Werte sein.
Rückgabecode Beschreibung
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 enthält.Entität.Domäne.
CERT_ALT_NAME_IP_ADDRESS
 Der Name ist eine Oktetzeichenfolge, 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 OID und einem binär-BLOB.

Anforderungen

   
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

ICertEncodeAltName::GetName

ICertEncodeAltName::SetNameEntry