Método IX509Enrollment2::InstallResponse2 (certenroll.h)

O método InstallResponse2 instala uma cadeia de certificados no computador de entidade final. A matriz de bytes que contém a resposta é codificada usando DER (Distinguished Encoding Rules ), conforme definido pelo padrão ASN.1 ( Abstract Syntax Notation One ). Você deve especificar a matriz de bytes codificada em DER em uma cadeia de caracteres que seja uma sequência binária pura ou que seja codificada por Unicode. Esse método está habilitado para a Web.

Sintaxe

HRESULT InstallResponse2(
  [in]           InstallResponseRestrictionFlags Restrictions,
  [in]           BSTR                            strResponse,
  [in]           EncodingType                    Encoding,
  [in, optional] BSTR                            strPassword,
  [in]           BSTR                            strEnrollmentPolicyServerUrl,
  [in]           BSTR                            strEnrollmentPolicyServerID,
  [in]           PolicyServerUrlFlags            EnrollmentPolicyServerFlags,
  [in]           X509EnrollmentAuthFlags         authFlags
);

Parâmetros

[in] Restrictions

Um valor de enumeração InstallResponseRestrictionFlags que especifica o tipo de certificados que podem ser instalados. Isso pode ser um ou mais dos valores a seguir.

[in] strResponse

Uma variável BSTR que contém a resposta codificada em DER.

[in] Encoding

Um valor de enumeração EncodingType que especifica o tipo de codificação aplicado à cadeia de caracteres que contém a resposta codificada em DER.

[in, optional] strPassword

Uma senha opcional para a instalação do certificado. Isso pode ser NULL para indicar que nenhuma senha é usada. Quando terminar de usar a senha, desmarque-a da memória chamando a função SecureZeroMemory . Para obter mais informações sobre como proteger a senha, consulte Como lidar com senhas.

[in] strEnrollmentPolicyServerUrl

Um BSTR que contém a URL do servidor cep (política de registro de certificado).

[in] strEnrollmentPolicyServerID

Um BSTR que contém um identificador para o servidor CEP.

[in] EnrollmentPolicyServerFlags

Um valor de enumeração PolicyServerUrlFlags . Esse pode ser um dos valores a seguir.

[in] authFlags

Um valor de enumeração X509EnrollmentAuthFlags que especifica o tipo de autenticação do cliente. Para o Windows 7, somente X509AuthCertificate pode ser escolhido entre os valores a seguir.

Valor de retorno

Se a função for bem-sucedida, a função retornará S_OK.

Se a função falhar, ela retornará um valor HRESULT que indica o erro. Os valores possíveis incluem, mas não se limitam a, aqueles na tabela a seguir. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT Comuns.

Observações

O método InstallResponse2 :

1. Recupera o certificado fictício do repositório externo.
2. Recupera o certificado contido na resposta e o instala no computador.
3. Copia as propriedades do certificado fictício no repositório externo para o certificado recém-instalado no repositório pessoal.

Antes de chamar o método InstallResponse2 , você deve inicializar o objeto IX509Enrollment chamando um dos métodos a seguir.

• inicializar
• InitializeFromRequest
• InitializeFromTemplate
• InitializeFromTemplateName

Se você chamar esse método da Web, poderá especificar apenas AllowNone ou AllowUntrustedRoot no parâmetro Restrictions . Se você especificar AllowNoOutstandingRequest ou AllowUntrustedCertificate, o método retornará um erro E_ACCESSDENIED .

Os últimos quatro parâmetros (strEnrollmentPolicyServerUrl, strEnrollmentPolicyServerID, EnrollmentPolicyServerFlags e authFlags) não estão incluídos no método InstallResponse . Eles permitem que você adicione um valor de propriedade ao certificado instalado da mesma maneira que a interface ICertPropertyEnrollmentPolicyServer .

Requirements

Consulte também

IX509Enrollment2