ICertAdmin2::GetCAPropertyDisplayName-Methode (certadm.h)

Artikel
02/26/2024

Die GetCAPropertyDisplayName-Methode ruft den Anzeigenamen der Eigenschaft für eine Zertifizierungsstelle -Eigenschaft (CA) ab. Diese Methode wurde zuerst in der ICertAdmin-Schnittstelle definiert.

Syntax

HRESULT GetCAPropertyDisplayName(
  [in]  const BSTR strConfig,
  [in]  LONG       PropId,
  [out] 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 der Einrichtung der Zertifikatdienste eingegeben wurde. Informationen zum Namen der Konfigurationszeichenfolge finden Sie unter ICertConfig.

WichtigGetCAPropertyDisplayName löscht den internen Cache nicht, wenn die Konfigurationszeichenfolge geändert wird. Wenn Sie die Konfigurationszeichenfolge für die Zertifizierungsstelle ändern, müssen Sie ein neues ICertAdmin-Objekt instanziieren und diese Methode erneut mit der neuen Konfigurationszeichenfolge aufrufen.

[in] PropId

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

[out] pstrDisplayName

Ein Zeiger auf die Zeichenfolge, die den Anzeigenamen der Eigenschaft darstellt.

Es liegt in der Verantwortung des Aufrufers, den BSTR frei zu geben, wenn er sysFreeString aufruft.

Rückgabewert

C++

Der Rückgabewert ist ein HRESULT. Der Wert S_OK gibt an, dass die Methode erfolgreich war.

VB

Eine Zeichenfolge, die den Anzeigenamen der Eigenschaft darstellt.

Anforderungen

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

Freigeben über