ICertAdmin2::SetCAProperty-Methode (certadm.h)

Artikel
07/16/2024

Die SetCAProperty--Methode legt einen Eigenschaftswert für die Zertifizierungsstelle (CA) fest.

Syntax

HRESULT SetCAProperty(
  [in] const BSTR strConfig,
  [in] LONG       PropId,
  [in] LONG       PropIndex,
  [in] LONG       PropType,
  [in] VARIANT    *pvarPropertyValue
);

Parameter

[in] strConfig

Zeichenfolgenwert, der eine gültige Konfigurationszeichenfolge für die Zertifizierungsstelle im Format COMPUTERNAME\CANAME darstellt, wobei COMPUTERNAME der Netzwerkname des Zertifikatdiensteservers ist, und CANAME ist der allgemeine Name der Zertifizierungsstelle, wie während der Einrichtung von Zertifikatdiensten eingegeben. Informationen zum Namen der Konfigurationszeichenfolge finden Sie unter ICertConfig.

WichtigSetCAProperty- 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 einen der folgenden Eigenschaftenbezeichner an.

Informationen zu allen Zertifizierungsstelleneigenschaften, einschließlich der eigenschaften, die schreibgeschützt sind, finden Sie unter ICertAdmin2::GetCAProperty.

Wert	Bedeutung
CR_PROP_KRACERT	Das Schlüsselwiederherstellungs-Agent-Zertifikat (KEY Recovery Agent, KRA) der Zertifizierungsstelle. Datenformat: binär, indiziert.
CR_PROP_KRACERTCOUNT	Anzahl der KRA-Zertifikate für die Zertifizierungsstelle. Datenformat: Long.
CR_PROP_KRACERTUSEDCOUNT	Anzahl der von der Zertifizierungsstelle verwendeten KRA-Zertifikate. Datenformat: Long.
CR_PROP_ROLESEPARATIONENABLED	Wert, der angibt, ob die Rollentrennung aktiviert ist. Datenformat: Long.
CR_PROP_TEMPLATES	Liste der vorlagen, die von der Zertifizierungsstelle unterstützt werden. Datenformat: Zeichenfolge.

[in] PropIndex

Wenn der PropId Parameter indiziert ist, wird der nullbasierte Index verwendet, 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. Dieser Parameter kann einer der folgenden Werte sein:

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

[in] pvarPropertyValue

C++-	Ein Zeiger auf einen VARIANT-, der den Eigenschaftswert angibt.
VB-	Ein Variant-, der den Eigenschaftswert angibt.

Rückgabewert

VB

Wenn die Funktion erfolgreich ist, wird der Rückgabewert S_OK.

Wenn die Funktion fehlschlägt, ist der Rückgabewert ein HRESULT-, der den Fehler angibt. Eine Liste allgemeiner Fehlercodes finden Sie unter Allgemeine HRESULT-Werte.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Keine unterstützt
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	certadm.h (include Certsrv.h)
Library	Certidl.lib
DLL-	Certadm.dll

Siehe auch

ICertAdmin2

ICertAdmin2::GetCAProperty

Freigeben über