Método ICertificateEnrollmentPolicyServerSetup::GetProperty (casetup.h)
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:
|
[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 |
|---|---|
|
O argumento propertyId não é um membro do tipo de enumeração CEPSetupProperty . |
|
O parâmetro pPropertyValue não pode ser NULL. |
|
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 |