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 |