Compartilhar via

Método ICertAdmin2::SetConfigEntry (certadm.h)

  • Artigo

O método SetConfigEntry define informações de configuração para uma AC (autoridade de certificação ).

Sintaxe

HRESULT SetConfigEntry(
  [in] const BSTR strConfig,
  [in] const BSTR strNodePath,
  [in] const BSTR strEntryName,
  [in] VARIANT    *pvarEntry
);

Parâmetros

[in] strConfig

Valor de cadeia de caracteres que representa uma cadeia de caracteres de configuração válida para a AC no formato COMPUTERNAME\CANAME, em que COMPUTERNAME é o nome de rede do servidor dos Serviços de Certificados e CANAME é o nome comum da AC, conforme inserido durante a instalação dos Serviços de Certificado. Para obter informações sobre o nome da cadeia de caracteres de configuração, consulte ICertConfig. Esse parâmetro pode ser uma cadeia de caracteres vazia, nesse caso, a função define informações de configuração que não são específicas para uma AC. Esse parâmetro não pode ser NULL.

SetConfigEntryimportante não limpa o cache interno quando a cadeia de caracteres de configuração é alterada. Ao alterar a cadeia de caracteres de configuração para a AC, você deve instanciar um novo objeto ICertAdmin e chamar esse método novamente com a nova cadeia de caracteres de configuração.
 

[in] strNodePath

Valor de cadeia de caracteres que representa o caminho do nó para as informações de configuração. Esse parâmetro pode ser uma cadeia de caracteres vazia, nesse caso, a função recupera informações de configuração do caminho identificado por strConfig. Esse parâmetro não pode ser NULL.

[in] strEntryName

Valor de cadeia de caracteres que representa o nome da entrada cujas informações estão sendo definidas. Esse valor pode ser uma cadeia de caracteres vazia, nesse caso, a entrada padrão é a entrada que está sendo definida. Esse parâmetro não pode ser NULL.

[in] pvarEntry

C++ Ponteiro para VARIANT que especifica as informações a serem definidas. Se esse valor estiver vazio, a chave indicada será excluída.
VB Variant que especifica as informações a serem definidas. Se esse valor estiver vazio, a chave indicada será excluída.

Valor retornado

VB

Se a função for bem-sucedida, o valor retornado será S_OK.

Se a função falhar, o valor retornado será um HRESULT que indica o erro. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

Comentários

As informações de configuração são armazenadas no registro no caminho a seguir.

HKEY_LOCAL_MACHINE\SISTEMA\Currentcontrolset\Serviços\Certsvc\Configuração\[CASANITIZEDNAME]\[strNodePath]\[strEntryName]

Onde CASANITIZEDNAME é o nome higienizado para a AC. Para obter mais informações sobre nomes higienizados, consulte ICertConfig2::GetConfig.

Requisitos

   
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 certadm.h (inclua Certsrv.h)
Biblioteca Certidl.lib
DLL Certadm.dll

Confira também

ICertAdmin2