Méthode IOCSPAdmin ::SetConfiguration (certadm.h)
La méthode SetConfiguration met à jour un service de répondeur avec des modifications de configuration.
Syntaxe
HRESULT SetConfiguration(
[in] const BSTR bstrServerName,
[in] VARIANT_BOOL bForce
);
Paramètres
[in] bstrServerName
Chaîne qui contient le nom du répondeur-service.
[in] bForce
| C++ | VARIANT_TRUE si la méthode doit mettre à jour le registre du service répondeur lorsque le service est hors connexion ou indisponible ; sinon, VARIANT_FALSE. Si le service est hors connexion ou indisponible et que le paramètre bForce est VARIANT_TRUE, SetConfiguration met directement à jour le registre du service répondeur. |
| VB | True si la méthode doit mettre à jour le registre du service répondeur lorsque le service est hors connexion ou indisponible ; sinon, False. Si le service est hors connexion ou indisponible et que le paramètre bForce a la valeur True, SetConfiguration met directement à jour le registre du service répondeur. |
Valeur retournée
VB
Si la méthode réussit, elle retourne S_OK.Si la méthode échoue, elle retourne une valeur HRESULT qui indique l’erreur. Pour obtenir la liste des codes d’erreur courants, consultez Valeurs HRESULT courantes.
Remarques
Le tableau suivant répertorie les effets de la valeur du paramètre bForce sur l’appel de méthode.
| Service de répondeur OCSP sur le serveur cible | bForce est VARIANT_TRUE | bForce est VARIANT_FALSE |
|---|---|---|
| Exécution en cours | Récupérez la configuration à partir du service. | Récupérez la configuration à partir du service. |
| Arrêté | Tentative de récupération de la configuration à partir du registre de serveurs. Si cette tentative échoue, retournez une erreur. | Retourne une erreur. |
Le tableau suivant répertorie les effets de la valeur du paramètre bForce sur l’appel de méthode.
| Service de répondeur OCSP sur le serveur cible | bForce a la valeur True | bForce a la valeur False |
|---|---|---|
| Exécution en cours | Récupérez la configuration à partir du service. | Récupérez la configuration à partir du service. |
| Arrêté | Tentative de récupération de la configuration à partir du registre de serveurs. Si cette tentative échoue, retournez une erreur. | Retourne une erreur. |
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Aucun pris en charge |
| Serveur minimal pris en charge | Windows Server 2008 Datacenter, Windows Server 2008 Entreprise [applications de bureau uniquement] |
| Plateforme cible | Windows |
| En-tête | certadm.h (include Certsrv.h) |
| Bibliothèque | Certadm.lib |
| DLL | Certadm.dll |