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

Article
08/22/2023

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

Partager via