ICertEncodeAltName::GetNameChoice-Methode (certenc.h)

Artikel
03/01/2024

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

Freigeben über