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

Confira também

ICertConfig

ICertManageModule