Método ISCrdEnr::setSigningCertificate

El método setSigningCertificate especifica un certificado de firma (también conocido como certificado del agente de inscripción).

Antes de inscribirse en nombre de los usuarios, debe seleccionar o establecer un certificado de firma. La clave privada asociada a este certificado de firma se usa para firmar una solicitud PKCS #7. El PKCS #7, a su vez, contiene la solicitud PKCS #10 del usuario (que está firmada con la clave privada del usuario).

Sintaxis

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

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

Parámetros

dwFlags [in]

Reservado para uso futuro. Establezca este valor en cero.

bstrCertTemplateName [in]

Nombre de la plantilla de certificado para el certificado de firma. Puede usar el valor "EnrollmentAgent" si ha obtenido un certificado EnrollmentAgent.

Valor devuelto

VB

Si el método se realiza correctamente, el método devuelve S_OK.

Si se produce un error en el método, devuelve un valor HRESULT que indica el error. Para obtener una lista de códigos de error comunes, consulte Valores HRESULT comunes.

Comentarios

Antes de inscribirse en nombre de un usuario, primero debe obtener un certificado de firma. Puede obtener un certificado de firma mediante el complemento MMC del Administrador de certificados. El método setSigningCertificate no obtiene el certificado de firma, sino que informa al control de inscripción de tarjetas inteligentes que obtuvo previamente el certificado de firma que se va a usar. El método setSigningCertificate busca en el almacén "My" del autor de la llamada el certificado de firma más reciente correspondiente a la plantilla de certificado especificada por bstrCertTemplateName.

Una alternativa a setSigningCertificate es ISCrdEnr::setSigningCertificate.

Después de establecer un certificado de firma, se puede recuperar su nombre llamando a ISCrdEnr::getSigningCertificateName.

Requisitos

Consulte también

ISCrdEnr

ISCrdEnr::getSigningCertificateName