Compartilhar via

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

  • Artigo

O método SetProperty especifica um valor de enumeração CESSetupProperty para a configuração do CES (Serviço Web de Registro de Certificado).

Sintaxe

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

Parâmetros

[in] propertyId

Um valor de enumeração CESSetupProperty que especifica o valor da propriedade a ser recuperado.

[in] pPropertyValue

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

Retornar valor

Código de retorno Descrição
E_INVALIDARG
 O argumento propertyId não é um membro do tipo de enumeração CESSetupProperty .

Além disso, se você estiver definindo a propriedade ENUM_CESSETUPPROP_AUTHENTICATION , deverá especificar um dos seguintes valores no argumento pPropertyValue :

  • X509AuthKerberos
  • X509AuthUsername
  • X509AuthCertificate
E_POINTER
 O parâmetro pPropertyValue não pode ser NULL.
HRESULT_FROM_WIN32(ERROR_INVALID_STATE)
 O objeto ICertificateEnrollmentServerSetup 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_CESSETUPPROP_AUTHENTICATION , o subtipo VARIANT deverá ser VT_I2, VT_I4 ou VT_UI4.

Comentários

Você deve chamar InitializeInstallDefaults antes de chamar SetProperty.

Não é possível definir a propriedade ENUM_CESSETUPPROP_URL .

Não é possível definir o ENUM_CESSETUPPROP_USE_IISAPPPOOLIDENTITY se o pool de aplicativos WSEnrollmentServer já existir e o WMI tiver sido inicializado.

Se você estiver definindo a propriedade ENUM_CESSETUPPROP_AUTHENTICATION , 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

Você não poderá definir a propriedade ENUM_CESSETUPPROP_CACONFIG se o servidor de destino for uma autoridade de certificação autônoma. A propriedade ErrorString será definida como "O Serviço Web de Registro de Certificado não pode ser usado com uma AC (autoridade de certificação) autônoma. Ele só pode ser usado com uma AC corporativa."

.

Requisitos

Requisito Valor
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

ICertificateEnrollmentServerSetup