Método ISCrdEnr::setSigningCertificate

O método setSigningCertificate especifica um certificado de autenticação (também conhecido como certificado do agente de registro).

Antes de se registrar em nome dos usuários, você deve selecionar ou definir um certificado de autenticação. A chave privada associada a esse certificado de autenticação é usada para assinar uma solicitação PKCS nº 7. O PKCS nº 7, por sua vez, contém a solicitação PKCS nº 10 do usuário (que é assinada com a chave privada do usuário).

Sintaxe

HRESULT setSigningCertificate(
  [in] DWORD dwFlags,
  [in] BSTR bstrCertTemplateName
);

SCrdEnr.setSigningCertificate( _
  ByVal dwFlags, _
  ByVal bstrCertTemplateName _
)

Parâmetros

dwFlags [in]

Reservado para uso futuro. Defina esse valor como zero.

bstrCertTemplateName [in]

Nome do modelo de certificado para o certificado de autenticação. Você pode usar o valor "EnrollmentAgent" se tiver obtido um certificado EnrollmentAgent.

Valor retornado

VB

Se o método for bem-sucedido, o método retornará S_OK.

Se o método falhar, ele retornará um valor HRESULT que indica o erro. Para obter uma lista de códigos de erro comuns, consulte Valores HRESULT comuns.

Comentários

Antes de se registrar em nome de um usuário, primeiro você deve obter um certificado de autenticação. Você pode obter um certificado de autenticação usando o snap-in MMC do Gerenciador de Certificados. O método setSigningCertificate não obtém o certificado de autenticação, mas informa o Controle de Registro de Cartão Inteligente que obteve anteriormente o certificado de autenticação a ser usado. O método setSigningCertificate pesquisa no repositório "My" do chamador o certificado de autenticação mais recente correspondente ao modelo de certificado especificado por bstrCertTemplateName.

Uma alternativa para setSigningCertificate é ISCrdEnr::setSigningCertificate.

Depois que um certificado de autenticação é definido, seu nome pode ser recuperado chamando ISCrdEnr::getSigningCertificateName.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Nenhum compatível
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
DLL	Scrdenrl.dll
IID	IID_ISCrdEnr é definido como 753988a1-1357-436d-9cf5-f089bdd67d64

Confira também

ISCrdEnr

ISCrdEnr::getSigningCertificateName