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

  • Artigo

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

Sintaxe

HRESULT GetProperty(
  [in]  CEPSetupProperty propertyId,
  [out] 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_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 Contém a URL do serviço CEP. 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_cep_AuthenticationType/service.svc/cep" em que o tipo de autenticação pode ser um dos seguintes:
  • Kerberos
  • usernamepassword
  • certificado

[out] 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 parâmetro pPropertyValue conterá uma das seguintes constantes se o método GetProperty retornar com êxito:

  • X509AuthKerberos
  • X509AuthUsername
  • X509AuthCertificate

Se você especificar ENUM_CEPSETUPPROP_SSLCERTHASH no parâmetro propertyId , o parâmetro pPropertyValue conterá um subtipo VT_BSTR que contém o hash se o método GetProperty retornar com êxito.

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.

Retornar valor

Código de retorno Descrição
E_INVALIDARG
 O argumento propertyId não é um membro do tipo de enumeração CEPSetupProperty .
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."

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

ICertificateEnrollmentPolicyServerSetup

InitializeInstallDefaults

SetProperty