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

Artigo
07/16/2024

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

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 de 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 da AC, você deve criar uma instância de um novo objeto ICertAdmin e chamar esse método novamente com a nova cadeia de caracteres de configuração.

[in] PropId

Especifica um dos seguintes identificadores de propriedade.

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: long.
CR_PROP_KRACERTUSEDCOUNT	Número de certificados KRA usados pela AC. Formato de dados: long.
CR_PROP_ROLESEPARATIONENABLED	Valor que especifica se a separação de função está habilitada. Formato de dados: long.
CR_PROP_TEMPLATES	Lista de modelos compatíveis com a AC. Formato de dados: String.

[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 ser um dos valores a seguir.

Valor	Significado
PROPTYPE_LONG	Assinado dados long.
PROPTYPE_DATE	Data/Hora (reservada para uso futuro).
PROPTYPE_BINARY	Dados binários.
PROPTYPE_STRING	dados de de cadeia de caracteres unicode.

[in] pvarPropertyValue

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

Valor de retorno

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
de cliente com suporte mínimo	Nenhum com suporte
servidor com suporte mínimo	Windows Server 2003 [somente aplicativos da área de trabalho]
da Plataforma de Destino	Windows
cabeçalho	certadm.h (inclua Certsrv.h)
biblioteca	Certidl.lib
de DLL	Certadm.dll

Consulte também

ICertAdmin2

ICertAdmin2::GetCAProperty

Compartilhar via