Interfaz IOpcDigitalSignatureManager (msopc.h)

Artículo
03/08/2023

Proporciona acceso a las interfaces de firma digital de empaquetado para un paquete representado por objetos packaging API. Se llama a estos métodos de interfaz para generar una firma o para acceder a las firmas existentes y validarlas en el paquete.

Herencia

La interfaz IOpcDigitalSignatureManager hereda de la interfaz IUnknown . IOpcDigitalSignatureManager también tiene estos tipos de miembros:

Métodos

La interfaz IOpcDigitalSignatureManager tiene estos métodos.


IOpcDigitalSignatureManager::CreateSigningOptions Crea un puntero de interfaz IOpcSigningOptions.
IOpcDigitalSignatureManager::GetSignatureEnumerator Obtiene un enumerador de punteros de interfaz IOpcDigitalSignature, que representan firmas de paquete.
IOpcDigitalSignatureManager::GetSignatureOriginPartName Obtiene un puntero de interfaz IOpcPartUri que representa el nombre de parte del elemento Origen de firma digital.
IOpcDigitalSignatureManager::RemoveSignature Quita del paquete una parte de firma especificada que almacena el marcado de firma.
IOpcDigitalSignatureManager::ReplaceSignatureXml Reemplaza el marcado de firma existente almacenado en una parte de firma especificada.
IOpcDigitalSignatureManager::SetSignatureOriginPartName Establece el nombre de la parte del origen de la firma digital en el nombre representado por un puntero de interfaz IOpcPartUri especificado.
IOpcDigitalSignatureManager::Sign Firma el paquete mediante la generación de una firma mediante el certificado especificado y el puntero de interfaz IOpcSigningOptions.
IOpcDigitalSignatureManager::Validate Valida una firma de paquete especificada mediante un certificado especificado.

Comentarios

Antes de llamar al método Sign para generar una firma, se debe llamar a los métodos IOpcSigningOptions::SetDefaultDigestMethod e IOpcSigningOptions::SetSignatureMethod .

Para crear un puntero de interfaz IOpcDigitalSignatureManager , llame al método IOpcFactory::CreateDigitalSignatureManager .

Importante Si el paquete se modifica mientras se ejecuta el método Sign , el método puede producir un error o generar una firma incoherente. Para evitar daños en el paquete, use las API para guardar el paquete antes de llamar a Sign. Para obtener información sobre cómo guardar un paquete, vea Guardar un paquete.

El método Validate comprueba que la firma especificada (entidades firmadas y el marcado de firma) no se ha modificado desde que se generó la firma, pero no valida la identidad del firmante.

Importante El autor de la llamada debe validar la identidad del firmante.

Seguridad para subprocesos

Los objetos de empaquetado no son seguros para subprocesos.

IOpcSigningOptions Para obtener más información, consulte la Introducción con la API de empaquetado.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [aplicaciones de escritorio \| Aplicaciones para UWP]
Servidor mínimo compatible	Windows Server 2008 R2 [aplicaciones de escritorio \| Aplicaciones para UWP]
Plataforma de destino	Windows
Encabezado	msopc.h