ICertEncodeAltName::GetNameChoice-Methode (certenc.h)

  • Artikel

Die GetNameChoice-Methode gibt die Namensauswahl an einem angegebenen Index eines alternativen Namensarrays 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 einen LONG-Wert , der den Namensauswahlspezifizierer empfängt.

Rückgabewert

C++

Wenn die Methode erfolgreich ist, gibt die Methode S_OK zurück, und der Parameter pNameChoice verweist auf einen Wert, der den Typ des alternativen Namens angibt. Dies ist einer 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 am angegebenen Index. Die Namensauswahl gibt den Typ des alternativen Namens an, damit er ordnungsgemäß verwendet werden kann. Er muss einen der folgenden Werte aufweisen.
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 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 einer OID und einem binären BLOB.

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

ICertEncodeAltName::GetName

ICertEncodeAltName::SetNameEntry