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

  • Artigo

O método SetCAProperty define um valor de propriedade para a AC (autoridade de certificação ).

Sintaxe

HRESULT SetCAProperty(
  [in] const BSTR strConfig,
  [in] LONG       PropId,
  [in] LONG       PropIndex,
  [in] LONG       PropType,
  [in] VARIANT    *pvarPropertyValue
);

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.

SetCAPropertyimportante 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] PropId

Especifica um dos identificadores de propriedade a seguir.

Para obter informações sobre todas as propriedades de AC, incluindo aquelas que são somente leitura, consulte ICertAdmin2::GetCAProperty.

Valor Significado
CR_PROP_KRACERT
 O certificado KRA (agente de recuperação de chave) da AC.

Formato de dados: binário, indexado.
CR_PROP_KRACERTCOUNT
 Número de certificados KRA para a AC.

Formato de dados: Longo.
CR_PROP_KRACERTUSEDCOUNT
 Número de certificados KRA usados pela AC.

Formato de dados: Longo.
CR_PROP_ROLESEPARATIONENABLED
 Valor que especifica se a separação de função está habilitada.

Formato de dados: Longo.
CR_PROP_TEMPLATES
 Lista de modelos compatíveis com a AC.

Formato de dados: cadeia de caracteres.

[in] PropIndex

Se o parâmetro PropId for indexado, o índice baseado em zero a ser usado ao recuperar o valor da propriedade. Se PropId não for indexado, esse valor será ignorado.

[in] PropType

Especifica o tipo da propriedade . Esse parâmetro pode usar um dos valores a seguir.

Valor Significado
PROPTYPE_LONG
 Dados long assinados.
PROPTYPE_DATE
 Data/hora (reservada para uso futuro).
PROPTYPE_BINARY
 Dados binários.
PROPTYPE_STRING
 Dados de cadeia decaracteres Unicode.

[in] pvarPropertyValue

C++ Um ponteiro para um VARIANT que especifica o valor da propriedade.
VB Uma Variant que especifica o valor da propriedade.

Retornar valor

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.

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

Confira também

ICertAdmin2

ICertAdmin2::GetCAProperty