Método IEnroll::acceptPKCS7Blob (xenroll.h)

  • Artigo

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

O método acceptPKCS7Blob 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 IEnroll .

Sintaxe

HRESULT acceptPKCS7Blob(
  [in] PCRYPT_DATA_BLOB pBlobPKCS7
);

Parâmetros

[in] pBlobPKCS7

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

Valor retornado

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 acceptPKCS7Blob 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 "cert begin" e "end cert"). O certificado e as chaves associadas geradas para ele são colocados no repositório MY. 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 ao repositório do usuário. 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, os repositórios do sistema MY, CA, ROOT e REQUEST são usados para armazenar os certificados. No entanto, você pode especificar outros repositórios atribuindo as seguintes propriedades antes de chamar esse método:

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

Confira também

IEnroll