Método ISCrdEnr::selectSigningCertificate

O método selectSigningCertificate exibe uma caixa de diálogo Selecionar Certificado , permitindo que um certificado de autenticação (também conhecido como certificado do agente de registro) seja selecionado.

Antes de se registrar em nome dos usuários, você deve selecionar 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 #10 do usuário (que é assinada com a chave privada do usuário).

Sintaxe

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

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

Parâmetros

dwFlags [in]

Reservado para uso futuro. Defina esse valor como zero.

bstrCertTemplateName [in]

Uma cadeia de caracteres que representa o nome do modelo de certificado para o certificado de assinatura. 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 selectSigningCertificate não obtém o certificado de assinatura, mas exibe uma caixa de diálogo de certificados de autenticação obtidos anteriormente, permitindo que você escolha qual certificado será usado para assinar as solicitações de registro em nome.

Uma alternativa para selecionarSigningCertificate é ISCrdEnr::setSigningCertificate.

Depois que um certificado de autenticação é selecionado, 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