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

O método SetConfiguration atualiza um serviço respondente com alterações de configuração.

Sintaxe

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

Parâmetros

[in] bstrServerName

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

[in] bForce

C++ VARIANT_TRUE se o método deve atualizar o registro de serviço respondente quando o serviço estiver offline ou indisponível; caso contrário, VARIANT_FALSE. Se o serviço estiver offline ou indisponível e o parâmetro bForce for VARIANT_TRUE, SetConfiguration atualizará o registro de serviço respondente diretamente.
VB True se o método deve atualizar o registro de serviço respondente quando o serviço estiver offline ou indisponível; caso contrário, False. Se o serviço estiver offline ou indisponível e o parâmetro bForce for True, SetConfiguration atualizará o registro de serviço respondente diretamente.

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.

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 bForce é VARIANT_TRUE bForce é 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.

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