ICertRequest2::GetCAPropertyFlags-Methode (certcli.h)

Artikel
02/26/2024

Die GetCAPropertyFlags-Methode ruft die Eigenschaftsflags für eine Zertifizierungsstelle -Eigenschaft (CA) ab.

Syntax

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

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.

[in] PropId

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

[out, retval] pPropFlags

Ein Zeiger auf einen LONG-Wert , der die Eigenschaftsflags darstellt.

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 ein Long-Wert , der die Eigenschaftsflags darstellt.

Hinweise

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

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

Im Gegensatz dazu benötigt die Zertifizierungsstelle in den Implementierungen ICertRequest2 und ICertRequest3 der -Methode standardmäßig keine Zugriffsrechte. Nur 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. Jeder schließt Anonym nicht ein. 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 (certsrv.h einschließen)
Bibliothek	Certidl.lib
DLL	Certcli.dll