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 |
|---|---|
|
O argumento propertyId não é um membro do tipo de enumeração CEPSetupProperty ou você tentou definir o valor ENUM_CEPSETUPPROP_URL . |
|
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." |
|
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 |