ICertRequest2::GetCAPropertyDisplayName-Methode (certcli.h)

Artikel
02/26/2024

Die GetCAPropertyDisplayName-Methode ruft den Anzeigenamen der Eigenschaft für eine Zertifizierungsstelle -Eigenschaft ab.

Syntax

HRESULT GetCAPropertyDisplayName(
  [in]          const BSTR strConfig,
  [in]          LONG       PropId,
  [out, retval] BSTR       *pstrDisplayName
);

Parameter

[in] strConfig

Stellt eine gültige Konfigurationszeichenfolge für die Zertifizierungsstelle im Format ComputerName\CAName dar, wobei ComputerName der Netzwerkname des Zertifikatdiensteservers und CAName der allgemeine Name der Zertifizierungsstelle ist, wie er während des Setups der Zertifikatdienste eingegeben wurde. Informationen zum Namen der Konfigurationszeichenfolge finden Sie unter ICertConfig.

[in] PropId

Gibt den Eigenschaftenbezeichner an. Informationen zu diesem Parameter finden Sie in der Tabelle in ICertAdmin2::GetCAProperty.

[out, retval] pstrDisplayName

Ein Zeiger auf den BSTR , der den Anzeigenamen der Eigenschaft darstellt. Wenn Sie die Verwendung des BSTR abgeschlossen haben, geben Sie ihn frei, indem Sie die SysFreeString-Funktion aufrufen.

Rückgabewert

C++

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.

VB

Der Rückgabewert ist eine Zeichenfolge , die den Anzeigenamen der Eigenschaft enthält.

Hinweise

Die Funktionalität der GetCAPropertyDisplayName-Methode ähnelt der der ICertAdmin2::GetCAPropertyDisplayName-Methode .

In der ICertAdmin2-Methode erzwingt die Zertifizierungsstelle, dass der Aufrufer über Lesezugriff der Zertifizierungsstelle verfügt, der in der Regel nur Ca Officers und Ca Administrators gewährt wird.

In den ICertRequest2- und ICertRequest3-Implementierungen der Methode erfordert die Zertifizierungsstelle standardmäßig keine Zugriffsrechte. Nur DCOM-Zugriffssteuerungslisten (Distributed Component Object Model, DCOM) werden erzwungen. für eine in die Domäne eingebundene Zertifizierungsstelle ermöglichen die DCOM-ACLs jedem Zugriff auf die Zertifizierungsstellen. Anonym ist nicht in jeder Person enthalten. Die Anforderungsschnittstelle der Zertifizierungsstelle kann mithilfe der Registrierungskonfiguration gesperrt werden, um zu erzwingen, dass der Aufrufer über Registrierungszugriff verfügt.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	certcli.h (include Certsrv.h)
Bibliothek	Certidl.lib
DLL	Certcli.dll