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 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 |