ICertificateEnrollmentServerSetup::SetProperty-Methode (casetup.h)

Artikel
08/22/2023

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

Freigeben über