Partager via


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