Método ICertManageModule::Configure (certmod.h)
O método Configure exibe a interface do usuário do módulo.
Sintaxe
HRESULT Configure(
[in] const BSTR strConfig,
[in] BSTR strStorageLocation,
[in] LONG Flags
);
Parâmetros
[in] strConfig
Representa a cadeia de caracteres de configuração para o servidor dos Serviços de Certificados no formato COMPUTERNAME\CANAME, em que COMPUTERNAME é o nome de rede do servidor de Serviços de Certificados e CANAME é o nome comum da AC (autoridade de certificação ), conforme inserido para a AC durante a instalação dos Serviços de Certificados. Para obter informações sobre o nome da cadeia de caracteres de configuração, consulte ICertConfig.
[in] strStorageLocation
Um local que fornece armazenamento para os valores de propriedade, conforme descrito na definição de strStorageLocation em ICertManageModule::GetProperty.
[in] Flags
Um valor usado para determinar se a interface de configuração deve ser apresentada ao usuário. Se esse valor for zero, o usuário receberá uma interface para configurar o módulo. Se esse valor for CMM_REFRESHONLY, os Serviços de Certificados não exibirão a interface do usuário, mas as alterações mais recentes na configuração do módulo estarão em vigor quando futuras solicitações de certificado forem processadas (isso permite que as alterações sejam incorporadas sem a necessidade de uma resposta a uma interface do usuário).
Retornar valor
VB
Se o método for bem-sucedido, o método 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
O método Configure exibe a interface do usuário do módulo (se houver), o que permite que o usuário exiba e altere os itens configuráveis do módulo. Um módulo que implementa ICertManageModule pode ter seu método Configure chamado quando a página de propriedades Política do Gerenciador de Serviços de Certificados ou Módulo de Saída está ativa e o usuário escolhe o botão Configurar . O Gerenciador de Serviços de Certificados passará o local referenciado por strStorageLocation para este módulo e a implementação desse método poderá usar esse local conforme necessário. Observe que é possível que um módulo não tenha itens configuráveis (portanto, uma interface do usuário não seria necessária), mas ainda seria necessário implementar esse método. O exemplo a seguir não permite que um usuário faça uma alteração de configuração, mas implementa esse método.
Exemplos
#include <windows.h>
#include <Certmod.h>
HRESULT CCertManagePolicyModule::Configure(
/* [in] */ const BSTR strConfig,
/* [in] */ BSTR strStorageLocation,
/* [in] */ LONG Flags)
{
if ( CMM_REFRESHONLY != Flags )
MessageBox(NULL,
L"This module has no configurable items",
L"MyModule",
(MB_OK|MB_ICONINFORMATION));
return S_OK;
}
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Nenhum compatível |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Plataforma de Destino | Windows |
| Cabeçalho | certmod.h (inclua Certsrv.h) |
| Biblioteca | Certidl.lib |