Observação
O acesso a essa página exige autorização. Você pode tentar entrar ou alterar diretórios.
O acesso a essa página exige autorização. Você pode tentar alterar os diretórios.
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 |