Share via

ICertificateEnrollmentPolicyServerSetup::GetProperty-Methode (casetup.h)

  • Artikel

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:
  • Kerberos
  • usernamepassword
  • Zertifikat

[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
E_INVALIDARG
 Das Argument propertyId ist kein Element des CEPSetupProperty-Enumerationstyps .
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."

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

Weitere Informationen

ICertificateEnrollmentPolicyServerSetup

InitializeInstallDefaults

SetProperty