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

  • Artigo

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

Sintaxe

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

Parâmetros

[in] propertyId

Um valor de enumeração CESSetupProperty que especifica o valor da propriedade a ser recuperado. Para obter mais informações, consulte Comentários.

[out] 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 .
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."

Comentários

O tipo de enumeração CESSetupProperty contém os seguintes valores:

  • ENUM_CESSETUPPROP_USE_IISAPPPOOLIDENTITY
  • ENUM_CESSETUPPROP_CACONFIG
  • ENUM_CESSETUPPROP_AUTHENTICATION
  • ENUM_CESSETUPPROP_SSLCERTHASH
  • ENUM_CESSETUPPROP_URL
  • ENUM_CESSETUPPROP_RENEWALONLY

Esses valores têm estes significados:

  • A propriedade ENUM_CESSETUPPROP_USE_IISAPPPOOLIDENTITY é um valor VT_BOOL que especifica se o contexto do servidor é ApplicationPoolIdentity.
  • A propriedade ENUM_CESSETUPPROP_CACONFIG contém uma cadeia de caracteres de configuração (VT_BSTR) de autoridade de certificação (CA) do formato computerDNSname/CAName em que computerDNSname é o nome DNS totalmente qualificado do servidor e CAName é o nome comum da AC.
  • A propriedade ENUM_CESSETUPPROP_AUTHENTICATION especifica o tipo de procedimento de autenticação usado. Se o método GetProperty retornar com êxito, o argumento pPropertyValue conterá uma das seguintes constantes:
    • X509AuthKerberos
    • X509AuthUsername
    • X509AuthCertificate
  • A propriedade ENUM_CESSETUPPROP_SSLCERTHASH contém o hash (VT_BSTR) do certificado usado durante a autenticação. A propriedade ENUM_CESSETUPPROP_AUTHENTICATION deve ser definida como X509AuthCertificate.
  • A propriedade ENUM_CESSETUPPROP_URL contém a URL do serviço CES. Se o método GetProperty retornar com êxito, o argumento pPropertyValue conterá um subtipo VT_BSTR que contém uma URL do formato "https:// computerDNSname/ADPolicyProvider_ces_AuthenticationType/service.svc/ces" em que o tipo de autenticação pode ser um dos seguintes:
    • Kerberos
    • usernamepassword
    • certificado
  • A propriedade ENUM_CESSETUPPROP_RENEWALONLY é um valor VT_BOOL que especifica se o CES pode processar apenas renovações de certificado.

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