ICertRequest2::GetCAProperty-Methode (certcli.h)

Artikel
02/26/2024

Die GetCAProperty-Methode ruft einen Eigenschaftswert für die Zertifizierungsstelle ab. Die Funktionalität dieser Methode ist identisch mit ICertAdmin2::GetCAProperty. Informationen zu dieser Methode finden Sie unter ICertAdmin2::GetCAProperty.

Syntax

HRESULT GetCAProperty(
  [in]          const BSTR strConfig,
  [in]          LONG       PropId,
  [in]          LONG       PropIndex,
  [in]          LONG       PropType,
  [in]          LONG       Flags,
  [out, retval] VARIANT    *pvarPropertyValue
);

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.

[in] PropIndex

Wenn PropId indiziert ist, der nullbasierte Index, der beim Abrufen des Eigenschaftswerts verwendet werden soll. Wenn PropId nicht indiziert ist, wird dieser Wert ignoriert.

[in] PropType

Gibt den Typ der Eigenschaft an, der der Type-Spalte in der PropId-Tabelle entspricht. Der Typ kann einer der folgenden Typen sein.

Wert	Bedeutung
PROPTYPE_LONG	Signierte lange Daten
PROPTYPE_DATE	Datum/Uhrzeit (für zukünftige Verwendung reserviert)
PROPTYPE_BINARY	Binärdaten
PROPTYPE_STRING	Unicode-Zeichenfolgendaten

[in] Flags

Die folgenden Flags können verwendet werden, um das Format des zurückgegebenen Eigenschaftswerts anzugeben. Diese Flags haben nur Bedeutung für Binärdaten (z. B. Zertifikate, Zertifikatketten oder Zertifikatsperrlisten) und werden andernfalls ignoriert.

Wert	Bedeutung
CV_OUT_BASE64	BASE64 ohne BEGIN/END
CV_OUT_BASE64HEADER	BASE64 mit BEGIN CERTIFICATE und END CERTIFICATE
CV_OUT_BASE64REQUESTHEADER	BASE64 mit BEGIN NEW CERTIFICATE REQUEST und END NEW CERTIFICATE REQUEST
CV_OUT_BASE64X509CRLHEADER	BASE64 mit BEGIN X509 CRL und END X509 CRL
CV_OUT_BINARY	Binary
CV_OUT_HEX	Hexadezimale Zeichenfolge
CV_OUT_HEXADDR	Hexadezimalzeichenfolge mit Adresse/Offset
CV_OUT_HEXASCII	Hexadezimalzeichenfolge mit ASCII
CV_OUT_HEXASCIIADDR	Hexadezimalzeichenfolge mit ASCII und Adresse/Offset

[out, retval] pvarPropertyValue

Ein Zeiger auf einen VARIANT-Wert , der den angeforderten Eigenschaftswert empfängt.

Wenn Sie die Verwendung von VARIANT abgeschlossen haben, geben Sie sie frei, indem Sie die VariantClear-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 ein Variant-Wert , der den angeforderten Eigenschaftswert empfängt.

Anforderungen

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

Weitere Informationen

CCertRequest

ICertRequest

ICertRequest2

Freigeben über