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 |