Método ICertAdmin2::GetConfigEntry (certadm.h)
O método GetConfigEntry recupera informações de configuração para uma AC (autoridade de certificação ).
Sintaxe
HRESULT GetConfigEntry(
[in] const BSTR strConfig,
[in] const BSTR strNodePath,
[in] const BSTR strEntryName,
[out] 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 Certificados. 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 recupera informações de configuração que não são específicas para uma AC. Esse parâmetro não pode ser NULL.
[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 recuperadas. Esse valor pode ser uma cadeia de caracteres vazia; nesse caso, todos os nomes de entrada são recuperados. Esse parâmetro não pode ser NULL.
[out] pvarEntry
Um ponteiro para um VARIANT que recebe as informações solicitadas.
Retornar valor
C++
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.
VB
O valor retornado é um Variant que representa as informações de configuração recuperadas.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 sanitizados, consulte ICertConfig2::GetConfig.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 | certadm.h (inclua Certsrv.h) |
Biblioteca | Certidl.lib |
DLL | Certadm.dll |