Partager via

ICertificateEnrollmentServerSetup ::SetProperty, méthode (casetup.h)

  • Article

La méthode SetProperty spécifie une valeur d’énumération CESSetupProperty pour la configuration du service web d’inscription de certificats (CES).

Syntaxe

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

Paramètres

[in] propertyId

Valeur d’énumération CESSetupProperty qui spécifie la valeur de propriété à récupérer.

[in] pPropertyValue

Pointeur vers une variable VARIANT qui contient la valeur de propriété.

Valeur retournée

Code de retour Description
E_INVALIDARG
 L’argument propertyId n’est pas membre du type d’énumération CESSetupProperty.

En outre, si vous définissez la propriété ENUM_CESSETUPPROP_AUTHENTICATION , vous devez spécifier l’une des valeurs suivantes dans l’argument pPropertyValue :

  • X509AuthKerberos
  • X509AuthUsername
  • X509AuthCertificate
E_POINTER
 Le paramètre pPropertyValue ne peut pas être NULL.
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)
 L’objet ICertificateEnrollmentServerSetup n’a pas été initialisé.

La valeur de la propriété ErrorString est définie sur « L’objet setup n’a pas été initialisé. Initialisez l’objet setup avec la méthode InitializeInstallDefaults. »
HRESULT_FROM_WIN32(ERROR_CLUSTER_PROPERTY_DATA_TYPE_MISMATCH)
 Si vous définissez la propriété ENUM_CESSETUPPROP_AUTHENTICATION , le sous-type VARIANT doit être VT_I2, VT_I4 ou VT_UI4.

Remarques

Vous devez appeler InitializeInstallDefaults avant d’appeler SetProperty.

Vous ne pouvez pas définir la propriété ENUM_CESSETUPPROP_URL .

Vous ne pouvez pas définir le ENUM_CESSETUPPROP_USE_IISAPPPOOLIDENTITY si le pool d’applications WSEnrollmentServer existe déjà et que WMI a été initialisé.

Si vous définissez la propriété ENUM_CESSETUPPROP_AUTHENTICATION , le sous-type VARIANT doit être VT_I2, VT_I4 ou VT_UII4, et l’argument pPropertyValue doit être l’une des constantes suivantes :

  • X509AuthKerberos
  • X509AuthUsername
  • X509AuthCertificate

Vous ne pouvez pas définir la propriété ENUM_CESSETUPPROP_CACONFIG si le serveur cible est une autorité de certification autonome. La propriété ErrorString sera définie sur « Le service web d’inscription de certificat ne peut pas être utilisé avec une autorité de certification autonome. Il ne peut être utilisé qu’avec une autorité de certification d’entreprise. »

.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible Windows
En-tête casetup.h
DLL Certocm.dll

Voir aussi

ICertificateEnrollmentServerSetup