Méthode ICertificateEnrollmentPolicyServerSetup::SetProperty (casetup.h)
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 |
|---|---|
|
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. |
|
Le paramètre pPropertyValue ne peut pas être NULL. |
|
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. » |
|
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 |