Compartir a través de


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

El método GetConfiguration se conecta a un servidor de respondedor del Protocolo de estado de certificado en línea (OCSP) e inicializa un objeto OCSPAdmin con la información de configuración del servidor.

Sintaxis

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

Parámetros

[in] bstrServerName

Cadena que contiene el nombre del respondedor-server.

[in] bForce

C++ VARIANT_TRUE si el autor de la llamada quiere leer la configuración del respondedor del registro del servidor cuando no se encuentra una instancia en ejecución del servicio de respondedor OCSP; de lo contrario, VARIANT_FALSE.
VB True si el autor de la llamada desea leer la configuración del respondedor del registro del servidor cuando no se encuentra una instancia en ejecución del servicio de respondedor OCSP; de lo contrario, False.

Valor devuelto

VB

Si el método se realiza correctamente, devuelve S_OK.

Si se produce un error en el método, devuelve un valor HRESULT que indica el error. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Si el método devuelve HRESULT_FROM_WIN32(ERROR_INVALID_STATE), la configuración ya se inicializa.

Si el método devuelve E_INVALIDARG, el parámetro pVal se estableció en NULL.

Comentarios

En la tabla siguiente se enumeran los efectos del valor del parámetro bForce en la llamada al método.

Servicio de respondedor OCSP en el servidor de destino bForce es VARIANT_TRUE bForce es VARIANT_FALSE
En ejecución Recupere la configuración del servicio. Recupere la configuración del servicio.
Detenido Intente recuperar la configuración del registro del servidor. Si se produce un error en este intento, devuelva un error. Devuelve un error.
 

En la tabla siguiente se enumeran los efectos del valor del parámetro bForce en la llamada al método.

Servicio de respondedor OCSP en el servidor de destino bForce es True bForce es False
En ejecución Recupere la configuración del servicio. Recupere la configuración del servicio.
Detenido Intente recuperar la configuración del registro del servidor. Si se produce un error en este intento, devuelva un error. Devuelve un error.
 

Este método intenta leer la configuración de una instancia en ejecución de un servicio de respondedor OCSP, pero es posible que no sea posible si el servicio no se está ejecutando o está en un estado inaccesible. El autor de la llamada puede indicar al método que lea la configuración del registro del servidor si no se encuentra una instancia en ejecución.

El método produce un error si intenta llamarlo más de una vez para un objeto OCSPAdmin determinado. Cada instancia de OCSPAdmin corresponde a un servidor de respondedor. Para conectarse a otro servidor en una matriz de servidores de respondedor OCSP, cree una nueva instancia de un objeto OCSPAdmin .

Requisitos

Requisito Value
Cliente mínimo compatible No se admite ninguno
Servidor mínimo compatible Windows Server 2008 Datacenter, Windows Server 2008 Enterprise [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado certadm.h (incluya Certsrv.h)
Library Certadm.lib
Archivo DLL Certadm.dll

Consulte también

IOCSPAdmin