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

Voir aussi

IOCSPAdmin