Compartilhar via


Método ICertificateEnrollmentPolicyServerSetup::SetProperty (casetup.h)

O método SetProperty especifica um valor de enumeração CEPSetupProperty para a configuração do Serviço Web da CEP (Política de Registro de Certificado).

Sintaxe

HRESULT SetProperty(
  [in] CEPSetupProperty propertyId,
  [in] VARIANT          *pPropertyValue
);

Parâmetros

[in] propertyId

Um valor da enumeração CEPSetupProperty que especifica o valor da propriedade a ser definido. Os valores a seguir são válidos.

Valor Descrição
ENUM_CEPSETUPPROP_AUTHENTICATION O parâmetro pPropertyValue contém um valor que identifica o tipo de autenticação a ser usado.
ENUM_CEPSETUPPROP_SSLCERTHASH O parâmetro pPropertyValue contém um hash do certificado, se houver, usado durante a autenticação. ENUM_CEPSETUPPROP_AUTHENTICATION deve ser definido como X509AuthCertificate.
ENUM_CEPSETUPPROP_KEYBASED_RENEWAL O parâmetro pPropertyValue especifica se o Servidor de Política de Registro deve ser configurado em um modo que retorna políticas somente para modelos KeyBasedRenewal.
ENUM_CEPSETUPPROP_URL Você não pode especificar esse valor.

[in] pPropertyValue

Um ponteiro para uma variável VARIANT que contém o valor da propriedade.

Se você especificar ENUM_CEPSETUPPROP_AUTHENTICATION no parâmetro propertyId , o subtipo VARIANT deverá ser VT_I2, VT_I4 ou VT_UII4 e o argumento pPropertyValue deverá ser uma das seguintes constantes:

  • X509AuthKerberos
  • X509AuthUsername
  • X509AuthCertificate

Se você especificar ENUM_CEPSETUPPROP_SSLCERTHASH no parâmetro propertyId , deverá definir o parâmetro pPropertyValue como um subtipo VT_BSTR que contém um hash do certificado usado para autenticação.

Se você especificar ENUM_CEPSETUPPROP_AUTHENTICATION no parâmetro propertyId , o parâmetro pPropertyValue conterá o procedimento de autenticação.

Se você especificar ENUM_CEPSETUPPROP_URL no parâmetro propertyId , o parâmetro pPropertyValue conterá a URL do Serviço Web da CEP (Política de Registro de Certificado).

Se você especificar ENUM_CEPSETUPPROP_KEYBASED_RENEWAL no parâmetro propertyId , deverá definir o parâmetro pPropertyValue como o subtipo VT_BOOL que indica se o Servidor de Política de Registro deve ser configurado em um modo que retorna políticas somente para modelos KeyBasedRenewal.

Valor retornado

Código de retorno Descrição
E_INVALIDARG
O argumento propertyId não é um membro do tipo de enumeração CEPSetupProperty ou você tentou definir o valor ENUM_CEPSETUPPROP_URL .
E_POINTER
O parâmetro pPropertyValue não pode ser NULL.
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)
O objeto ICertificateEnrollmentPolicyServerSetup não foi inicializado.

O valor da propriedade ErrorString é definido como "O objeto de instalação não foi inicializado. Inicialize o objeto de instalação com o método InitializeInstallDefaults."

HRESULT_FROM_WIN32(ERROR_CLUSTER_PROPERTY_DATA_TYPE_MISMATCH)
Se você estiver definindo a propriedade ENUM_CEPSETUPPROP_AUTHENTICATION , o subtipo VARIANT deverá ser VT_I2, VT_I4 ou VT_UI4.

Comentários

Você deve chamar InitializeInstallDefaults antes de chamar o método SetProperty .

Requisitos

   
Cliente mínimo com suporte Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino Windows
Cabeçalho casetup.h
DLL Certocm.dll

Confira também

GetProperty

ICertificateEnrollmentPolicyServerSetup

InitializeInstallDefaults