Método ICEnroll::acceptPKCS7 (xenroll.h)

Artigo
08/28/2023

[Esse método não está mais disponível para uso a partir do Windows Server 2008 e do Windows Vista.]

O método acceptPKCS7 aceita e processa uma mensagem PKCS nº 7 que contém um certificado. O PKCS nº 7 é a entrada como um parâmetro. Esse método foi definido pela primeira vez na interface ICEnroll .

Sintaxe

HRESULT acceptPKCS7(
  [in] BSTR PKCS7
);

Parâmetros

[in] PKCS7

Representa o PKCS nº 7 codificado em base64 que contém o certificado e a cadeia de certificados que identifica o emissor.

Valor retornado

VB

O valor retornado é um HRESULT. Um valor de S_OK indica êxito. Após a conclusão bem-sucedida dessa função, o PKCS nº 7 será aceito.

Comentários

A entrada PKCS nº 7 como um parâmetro para acceptPKCS7 contém o certificado de solicitação e a cadeia de certificados que identificam o emissor do certificado. Normalmente, mas nem sempre, a cadeia de certificados não inclui a raiz. O PKCS nº 7 pode estar no formato de certificado codificado em base64, binário ou X.509 (com ou sem as marcas de certificado de início/certificado final). O certificado e as chaves associadas geradas para ele são colocados no meu repositório. Um certificado raiz é colocado no repositório ROOT e o restante da cadeia de certificados é colocado no repositório de AC (autoridade de certificação ). Se algum certificado ROOT encontrado no PKCS nº 7 for aceito, o Crypt32 notificará o usuário de que um certificado ROOT está sendo adicionado à sua loja. O usuário tem a opção de recusar o certificado ROOT. Essa opção é fornecida para que o usuário possa recusar a colocação de uma raiz não confiável no repositório ROOT. Recusar a colocação do ROOT no repositório ROOT não fará com que o Controle de Registro de Certificado falhe na aceitação.

Por padrão, o sistema armazena MY, CA, ROOT e REQUEST para armazenar os certificados. No entanto, você pode especificar outros repositórios atribuindo as seguintes propriedades antes de chamar esse método:

Quando esse método é chamado do script, o método exibe uma interface do usuário que pergunta se o usuário permitirá a instalação de um certificado.

Requisitos


Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	xenroll.h
Biblioteca	Uuid.lib
DLL	Xenroll.dll