Méthode IOCSPAdmin ::GetConfiguration (certadm.h)

La méthode GetConfiguration se connecte à un serveur de répondeur OCSP (Online Certificate Status Protocol) et initialise un objet OCSPAdmin avec les informations de configuration du serveur.

Syntaxe

HRESULT GetConfiguration(
  [in] const BSTR   bstrServerName,
  [in] VARIANT_BOOL bForce
);

Paramètres

[in] bstrServerName

Chaîne qui contient le nom du répondeur-serveur.

[in] bForce

C++	VARIANT_TRUE si l’appelant souhaite lire la configuration du répondeur à partir du registre du serveur lorsqu’un instance en cours d’exécution du service de répondeur OCSP est introuvable ; sinon, VARIANT_FALSE.
VB	True si l’appelant souhaite lire la configuration du répondeur à partir du registre du serveur lorsqu’un instance en cours d’exécution du service de répondeur OCSP est introuvable ; sinon, False.

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.

Si la méthode retourne HRESULT_FROM_WIN32(ERROR_INVALID_STATE), la configuration est déjà initialisée.

Si la méthode retourne E_INVALIDARG, le paramètre pVal a été défini sur NULL.

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.

 

Cette méthode tente de lire la configuration à partir d’un instance en cours d’exécution d’un service de répondeur OCSP, mais cela peut ne pas être possible si le service n’est pas en cours d’exécution ou est dans un état inaccessible. L’appelant peut demander à la méthode de lire la configuration à partir du registre du serveur si un instance en cours d’exécution est introuvable.

La méthode échoue si vous essayez de l’appeler plusieurs fois pour un objet OCSPAdmin donné. Chaque instance d’OCSPAdmin correspond à un serveur répondeur. Pour vous connecter à un autre serveur dans un tableau de serveurs de répondeurs OCSP, créez un instance d’un objet OCSPAdmin.

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