Partager via

Méthode ICertificateEnrollmentPolicyServerSetup::SetProperty (casetup.h)

  • Article

La méthode SetProperty spécifie une valeur d’énumération CEPSetupProperty pour la configuration du service web CEP (Certificate Enrollment Policy).

Syntaxe

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

Paramètres

[in] propertyId

Valeur de l’énumération CEPSetupProperty qui spécifie la valeur de propriété à définir. Les valeurs suivantes sont valides.

Valeur Description
ENUM_CEPSETUPPROP_AUTHENTICATION Le paramètre pPropertyValue contient une valeur qui identifie le type d’authentification à utiliser.
ENUM_CEPSETUPPROP_SSLCERTHASH Le paramètre pPropertyValue contient un hachage du certificat, le cas échéant, utilisé lors de l’authentification. ENUM_CEPSETUPPROP_AUTHENTICATION doit être défini sur X509AuthCertificate.
ENUM_CEPSETUPPROP_KEYBASED_RENEWAL Le paramètre pPropertyValue spécifie s’il faut configurer le serveur de stratégies d’inscription dans un mode qui retourne des stratégies pour les modèles KeyBasedRenewal uniquement.
ENUM_CEPSETUPPROP_URL Vous ne pouvez pas spécifier cette valeur.

[in] pPropertyValue

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

Si vous spécifiez ENUM_CEPSETUPPROP_AUTHENTICATION dans le paramètre propertyId , 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

Si vous spécifiez ENUM_CEPSETUPPROP_SSLCERTHASH dans le paramètre propertyId , vous devez définir le paramètre pPropertyValue sur un sous-type VT_BSTR qui contient un hachage du certificat utilisé pour l’authentification.

Si vous spécifiez ENUM_CEPSETUPPROP_AUTHENTICATION dans le paramètre propertyId , le paramètre pPropertyValue contient la procédure d’authentification.

Si vous spécifiez ENUM_CEPSETUPPROP_URL dans le paramètre propertyId , le paramètre pPropertyValue contient l’URL du service web CEP (Certificate Enrollment Policy).

Si vous spécifiez ENUM_CEPSETUPPROP_KEYBASED_RENEWAL dans le paramètre propertyId , vous devez définir le paramètre pPropertyValue sur le sous-type VT_BOOL qui indique s’il faut configurer le serveur de stratégie d’inscription dans un mode qui retourne des stratégies pour les modèles KeyBasedRenewal uniquement.

Valeur retournée

Code de retour Description
E_INVALIDARG
 L’argument propertyId n’est pas membre du type d’énumération CEPSetupProperty ou vous avez essayé de définir la valeur ENUM_CEPSETUPPROP_URL.
E_POINTER
 Le paramètre pPropertyValue ne peut pas être NULL.
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)
 L’objet ICertificateEnrollmentPolicyServerSetup 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_CEPSETUPPROP_AUTHENTICATION , le sous-type VARIANT doit être VT_I2, VT_I4 ou VT_UI4.

Remarques

Vous devez appeler InitializeInstallDefaults avant d’appeler la méthode SetProperty .

Configuration requise

   
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

GetProperty

ICertificateEnrollmentPolicyServerSetup

InitializeInstallDefaults