Freigeben über

ICertificateEnrollmentPolicyServerSetup::SetProperty-Methode (casetup.h)

  • Artikel

Die SetProperty-Methode gibt einen CEPSetupProperty-Enumerationswert für die CEP-Webdienstkonfiguration (Certificate Enrollment Policy) an.

Syntax

HRESULT SetProperty(
  [in] CEPSetupProperty propertyId,
  [in] VARIANT          *pPropertyValue
);

Parameter

[in] propertyId

Ein Wert der CEPSetupProperty-Enumeration , der den festzulegenden Eigenschaftswert angibt. Die folgenden Werte sind gültig.

Wert BESCHREIBUNG
ENUM_CEPSETUPPROP_AUTHENTICATION Der Parameter pPropertyValue enthält einen Wert, der den typ der zu verwendenden Authentifizierung angibt.
ENUM_CEPSETUPPROP_SSLCERTHASH Der Parameter pPropertyValue enthält einen Hash des Zertifikats, sofern vorhanden, das während der Authentifizierung verwendet wird. ENUM_CEPSETUPPROP_AUTHENTICATION muss auf X509AuthCertificate festgelegt werden.
ENUM_CEPSETUPPROP_KEYBASED_RENEWAL Der Parameter pPropertyValue gibt an, ob der Registrierungsrichtlinienserver in einem Modus eingerichtet werden soll, der Richtlinien nur für KeyBasedRenewal-Vorlagen zurückgibt.
ENUM_CEPSETUPPROP_URL Sie können diesen Wert nicht angeben.

[in] pPropertyValue

Ein Zeiger auf eine VARIANT-Variable , die den Eigenschaftswert enthält.

Wenn Sie im propertyId-Parameter ENUM_CEPSETUPPROP_AUTHENTICATION angeben, muss der VARIANT-UntertypVT_I2, VT_I4 oder VT_UII4 sein, und das Argument pPropertyValue muss eine der folgenden Konstanten sein:

  • X509AuthKerberos
  • X509AuthUsername
  • X509AuthCertificate

Wenn Sie im propertyId-Parameter ENUM_CEPSETUPPROP_SSLCERTHASH angeben, müssen Sie den pPropertyValue-Parameter auf einen VT_BSTR Untertyp festlegen, der einen Hash des für die Authentifizierung verwendeten Zertifikats enthält.

Wenn Sie ENUM_CEPSETUPPROP_AUTHENTICATION im propertyId-Parameter angeben, enthält der Parameter pPropertyValue die Authentifizierungsprozedur.

Wenn Sie im propertyId-Parameter ENUM_CEPSETUPPROP_URL angeben, enthält der Parameter pPropertyValue die CEP-Webdienst-URL (Certificate Enrollment Policy).

Wenn Sie ENUM_CEPSETUPPROP_KEYBASED_RENEWAL im propertyId-Parameter angeben, müssen Sie den pPropertyValue-Parameter auf den VT_BOOL Untertyp festlegen, der angibt, ob der Registrierungsrichtlinienserver in einem Modus eingerichtet werden soll, der Richtlinien nur für KeyBasedRenewal-Vorlagen zurückgibt.

Rückgabewert

Rückgabecode Beschreibung
E_INVALIDARG
 Das Argument propertyId ist kein Element des CEPSetupProperty-Enumerationstyps , oder Sie haben versucht, den ENUM_CEPSETUPPROP_URL Wert festzulegen.
E_POINTER
 Der pPropertyValue-Parameter darf nicht NULL sein.
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)
 Das ICertificateEnrollmentPolicyServerSetup-Objekt wurde nicht initialisiert.

Der Wert der ErrorString-Eigenschaft ist auf "Das Setupobjekt wurde nicht initialisiert. Initialisieren Sie das Setupobjekt mit der InitializeInstallDefaults-Methode."
HRESULT_FROM_WIN32(ERROR_CLUSTER_PROPERTY_DATA_TYPE_MISMATCH)
 Wenn Sie die eigenschaft ENUM_CEPSETUPPROP_AUTHENTICATION festlegen, muss der VARIANT-UntertypVT_I2, VT_I4 oder VT_UI4 sein.

Hinweise

Sie müssen InitializeInstallDefaults aufrufen, bevor Sie die SetProperty-Methode aufrufen.

Anforderungen

   
Unterstützte Mindestversion (Client) Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform Windows
Kopfzeile casetup.h
DLL Certocm.dll

Weitere Informationen

GetProperty

ICertificateEnrollmentPolicyServerSetup

InitializeInstallDefaults