ICertificateEnrollmentPolicyServerSetup::GetProperty-Methode (casetup.h)
Die GetProperty-Methode ruft einen CEPSetupProperty-Enumerationswert für die CEP-Webdienstkonfiguration (Certificate Enrollment Policy) ab.
Syntax
HRESULT GetProperty(
[in] CEPSetupProperty propertyId,
[out] 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_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 |
Enthält die CEP-Dienst-URL. Wenn die GetProperty-Methode erfolgreich zurückgegeben wird, enthält das pPropertyValue-Argument einen VT_BSTR Untertyp, der eine URL im Format "https:// computerDNSname/ADPolicyProvider_cep_AuthenticationType/service.svc/cep" enthält, wobei der Authentifizierungstyp wie folgt aussehen kann:
|
[out] pPropertyValue
Ein Zeiger auf eine VARIANT-Variable , die den Eigenschaftswert enthält.
Wenn Sie ENUM_CEPSETUPPROP_AUTHENTICATION im propertyId-Parameter angeben, enthält der Parameter pPropertyValue eine der folgenden Konstanten, wenn die GetProperty-Methode erfolgreich zurückgegeben wird:
- X509AuthKerberos
- X509AuthUsername
- X509AuthCertificate
Wenn Sie ENUM_CEPSETUPPROP_SSLCERTHASH im propertyId-Parameter angeben, enthält der pPropertyValue-Parameter einen VT_BSTR Untertyp, der den Hash enthält, wenn die GetProperty-Methode erfolgreich zurückgegeben wird.
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 . |
|
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." |
Anforderungen
| Anforderung | Wert |
|---|---|
| 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 |