ICertManageModule::SetProperty-Methode (certmod.h)

Artikel
08/22/2023

Mit der SetProperty-Methode kann ein Modul einen Eigenschaftswert festlegen.

Syntax

HRESULT SetProperty(
  [in] const BSTR    strConfig,
  [in] BSTR          strStorageLocation,
  [in] BSTR          strPropertyName,
  [in] LONG          Flags,
  [in] const VARIANT *pvarProperty
);

Parameter

[in] strConfig

Stellt die Konfigurationszeichenfolge für den Zertifikatdiensteserver 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 für die Zertifizierungsstelle eingegeben wurde. Informationen zum Namen der Konfigurationszeichenfolge finden Sie unter ICertConfig.

[in] strStorageLocation

Der Speicherort, der Speicher für die Eigenschaftswerte bereitstellt, wie in der Definition von strStorageLocation in ICertManageModule::GetProperty beschrieben.

[in] strPropertyName

Der Name der Eigenschaft, deren Wert zugewiesen wird. Richtlinien- und Exitmodule sollten die folgenden Eigenschaften unterstützen, die vom Certificate Services Manager verwendet werden.

Wert	Bedeutung
Name	Der Name des Moduls.
Beschreibung	Beschreibung des Moduls.
Copyright	Copyright in Bezug auf das Modul.
Dateiversion	Version der Moduldatei.
Produktversion	Version des Moduls.

[in] Flags

Dieser Parameter ist reserviert und muss auf null festgelegt werden.

[in] pvarProperty

Ein Wert, der der von strPropertyName angegebenen Eigenschaft zugewiesen wird.

Rückgabewert

VB

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.

Hinweise

Diese Methode ist für zukünftige Funktionen vorgesehen. Es ist jedoch eine minimale Implementierung erforderlich, um die Anforderungen der ICertManageModule-Schnittstelle zu erfüllen.

Beispiele

#include <windows.h>
#include <Certmod.h>

HRESULT CCertManagePolicyModule::SetProperty(
            /* [in] */ const BSTR strConfig,
            /* [in] */ BSTR strStorageLocation,
            /* [in] */ BSTR strPropertyName,
            /* [in] */ LONG Flags,
            /* [in] */ const VARIANT *pvarProperty)
{
    // This implementation fulfills the minimal requirement
    // needed for ICertManageModule::SetProperty.
    return S_OK;
}

Anforderungen

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