Hinweis
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, sich anzumelden oder das Verzeichnis zu wechseln.
Für den Zugriff auf diese Seite ist eine Autorisierung erforderlich. Sie können versuchen, das Verzeichnis zu wechseln.
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 |