ICertificateEnrollmentPolicyServerSetup::SetProperty-Methode (casetup.h)
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 |
|---|---|
|
Das Argument propertyId ist kein Element des CEPSetupProperty-Enumerationstyps , oder Sie haben versucht, den ENUM_CEPSETUPPROP_URL Wert festzulegen. |
|
Der pPropertyValue-Parameter darf nicht NULL sein. |
|
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." |
|
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 |