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

O método GetConfiguration conecta-se a um servidor respondente do OCSP (Protocolo de Status de Certificado Online) e inicializa um objeto OCSPAdmin com as informações de configuração do servidor.

Sintaxe

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

Parâmetros

[in] bstrServerName

Uma cadeia de caracteres que contém o nome do respondente-servidor.

[in] bForce

C++	VARIANT_TRUE se o chamador quiser ler a configuração do respondente do registro do servidor quando uma instância em execução do serviço respondente OCSP não puder ser encontrada; caso contrário, VARIANT_FALSE.
VB	True se o chamador quiser ler a configuração do respondente do registro do servidor quando uma instância em execução do serviço respondente OCSP não puder ser encontrada; caso contrário, False.

Retornar valor

VB

Se o método for bem-sucedido, ele retornará S_OK.

Se o método falhar, ele retornará um valor HRESULT que indica o erro. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

Se o método retornar HRESULT_FROM_WIN32(ERROR_INVALID_STATE), a configuração já será inicializada.

Se o método retornar E_INVALIDARG, o parâmetro pVal foi definido como NULL.

Comentários

A tabela a seguir lista os efeitos do valor do parâmetro bForce na chamada de método.

Serviço respondente OCSP no servidor de destino	o bForce está VARIANT_TRUE	o bForce está VARIANT_FALSE
Executando	Recupere a configuração do serviço.	Recupere a configuração do serviço.
Parado	Tente recuperar a configuração do registro do servidor. Se essa tentativa falhar, retorne um erro.	Retornar um erro.

 

A tabela a seguir lista os efeitos do valor do parâmetro bForce na chamada de método.

Serviço respondente OCSP no servidor de destino	bForce é True	bForce é False
Executando	Recupere a configuração do serviço.	Recupere a configuração do serviço.
Parado	Tente recuperar a configuração do registro do servidor. Se essa tentativa falhar, retorne um erro.	Retornar um erro.

 

Esse método tenta ler a configuração de uma instância em execução de um serviço respondente OCSP, mas isso pode não ser possível se o serviço não estiver em execução ou estiver em um estado inacessível. O chamador pode instruir o método a ler a configuração do registro do servidor se uma instância em execução não puder ser encontrada.

O método falhará se você tentar chamá-lo mais de uma vez para um determinado objeto OCSPAdmin . Cada instância de OCSPAdmin corresponde a um servidor respondente. Para se conectar a outro servidor em uma matriz de servidores respondentes OCSP, crie uma nova instância de um objeto OCSPAdmin .

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Nenhum compatível
Servidor mínimo com suporte	Windows Server 2008 Datacenter, Windows Server 2008 Enterprise [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	certadm.h (inclua Certsrv.h)
Biblioteca	Certadm.lib
DLL	Certadm.dll

Confira também

IOCSPAdmin