Método ICertManageModule::SetProperty (certmod.h)

Artigo
02/26/2024

O método SetProperty permite que um módulo defina um valor de propriedade.

Sintaxe

HRESULT SetProperty(
  [in] const BSTR    strConfig,
  [in] BSTR          strStorageLocation,
  [in] BSTR          strPropertyName,
  [in] LONG          Flags,
  [in] const VARIANT *pvarProperty
);

Parâmetros

[in] strConfig

Representa a cadeia de caracteres de configuração para o servidor de Serviços de Certificados 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 (autoridade de certificação ), conforme inserido para a AC 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.

[in] strStorageLocation

O local que fornece armazenamento para os valores de propriedade, conforme descrito na definição de strStorageLocation em ICertManageModule::GetProperty.

[in] strPropertyName

O nome da propriedade cujo valor está sendo atribuído. Os módulos de política e saída devem dar suporte às propriedades a seguir, que são usadas pelo Gerenciador de Serviços de Certificados.

Valor	Significado
Nome	Nome do módulo.
Descrição	Descrição do módulo.
Direitos autorais	Direitos autorais relativos ao módulo.
Versão do Arquivo	Versão do arquivo de módulo.
Versão do produto	Versão do módulo.

[in] Flags

Esse parâmetro é reservado e deve ser definido como zero.

[in] pvarProperty

Um valor que está sendo atribuído à propriedade especificada por strPropertyName.

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

Esse método destina-se à funcionalidade futura. No entanto, é necessária uma implementação mínima para atender aos requisitos da interface ICertManageModule .

Exemplos

#include <windows.h>
#include <Certmod.h>

HRESULT CCertManagePolicyModule::SetProperty(
            /* [in] */ const BSTR strConfig,
            /* [in] */ BSTR strStorageLocation,
            /* [in] */ BSTR strPropertyName,
            /* [in] */ LONG Flags,
            /* [in] */ const VARIANT *pvarProperty)
{
    // This implementation fulfills the minimal requirement
    // needed for ICertManageModule::SetProperty.
    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