Freigeben über

ICertificateEnrollmentServerSetup::SetProperty-Methode (casetup.h)

  • Artikel

Die SetProperty-Methode gibt einen CESSetupProperty-Enumerationswert für die Ces-Konfiguration (Certificate Enrollment Web Service) an.

Syntax

HRESULT SetProperty(
  [in] CESSetupProperty propertyId,
  [in] VARIANT          *pPropertyValue
);

Parameter

[in] propertyId

Ein CESSetupProperty-Enumerationswert , der den abzurufenden Eigenschaftswert angibt.

[in] pPropertyValue

Ein Zeiger auf eine VARIANT-Variable , die den Eigenschaftswert enthält.

Rückgabewert

Rückgabecode Beschreibung
E_INVALIDARG
 Das argument propertyId ist kein Member des CESSetupProperty-Enumerationstyps .

Wenn Sie die ENUM_CESSETUPPROP_AUTHENTICATION-Eigenschaft festlegen, müssen Sie außerdem einen der folgenden Werte im pPropertyValue-Argument angeben:

  • X509AuthKerberos
  • X509AuthUsername
  • X509AuthCertificate
E_POINTER
 Der pPropertyValue-Parameter darf nicht NULL sein.
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)
 Das ICertificateEnrollmentServerSetup-Objekt wurde nicht initialisiert.

Der Wert der ErrorString-Eigenschaft ist auf "Das Setupobjekt wurde nicht initialisiert. Initialisieren Sie das Setupobjekt mit der InitializeInstallDefaults-Methode."
HRESULT_FROM_WIN32(ERROR_CLUSTER_PROPERTY_DATA_TYPE_MISMATCH)
 Wenn Sie die ENUM_CESSETUPPROP_AUTHENTICATION-Eigenschaft festlegen, muss der VARIANT-UntertypVT_I2, VT_I4 oder VT_UI4 sein.

Hinweise

Sie müssen InitializeInstallDefaults aufrufen, bevor Sie SetProperty aufrufen.

Sie können die eigenschaft ENUM_CESSETUPPROP_URL nicht festlegen.

Sie können die ENUM_CESSETUPPROP_USE_IISAPPPOOLIDENTITY nicht festlegen, wenn der WSEnrollmentServer-Anwendungspool bereits vorhanden ist und WMI initialisiert wurde.

Wenn Sie die ENUM_CESSETUPPROP_AUTHENTICATION-Eigenschaft festlegen, muss der VARIANT-UntertypVT_I2, VT_I4 oder VT_UII4 sein, und das pPropertyValue-Argument muss eine der folgenden Konstanten sein:

  • X509AuthKerberos
  • X509AuthUsername
  • X509AuthCertificate

Sie können die eigenschaft ENUM_CESSETUPPROP_CACONFIG nicht festlegen, wenn der Zielserver eine eigenständige Zertifizierungsstelle ist. Die ErrorString-Eigenschaft wird auf "Der Zertifikatregistrierungswebdienst kann nicht mit einer eigenständigen Zertifizierungsstelle (CA) verwendet werden. Sie kann nur mit einer Unternehmenszertifizierungsstelle verwendet werden."

.

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

ICertificateEnrollmentServerSetup