Interfaz IOpcSigningOptions (msopc.h)

Artículo
03/08/2023

Proporciona métodos para establecer y obtener acceso a la información necesaria para generar una firma.

Herencia

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

Métodos

La interfaz IOpcSigningOptions tiene estos métodos.


IOpcSigningOptions::GetCertificateEmbeddingOption Obtiene un valor que especifica la ubicación de almacenamiento en el paquete del certificado que se va a usar para la firma.
IOpcSigningOptions::GetCertificateSet Obtiene un puntero de interfaz IOpcCertificateSet.
IOpcSigningOptions::GetCustomObjectSet Obtiene una interfaz IOpcSignatureCustomObjectSet.
IOpcSigningOptions::GetCustomReferenceSet Obtiene un puntero de interfaz IOpcSignatureReferenceSet.
IOpcSigningOptions::GetDefaultDigestMethod Obtiene el método de resumen predeterminado que se usará para calcular los valores de resumen de los objetos que se van a firmar.
IOpcSigningOptions::GetSignatureId Obtiene el valor del atributo Id del elemento Signature.
IOpcSigningOptions::GetSignatureMethod Obtiene el método de firma que se va a usar para calcular y cifrar el valor hash del elemento SignedInfo, que se serializará como el elemento SignatureValue de la firma.
IOpcSigningOptions::GetSignaturePartName Obtiene el nombre de parte de la parte de firma donde se almacenará el marcado de firma.
IOpcSigningOptions::GetSignaturePartReferenceSet Obtiene una interfaz IOpcSignaturePartReferenceSet.
IOpcSigningOptions::GetSignatureRelationshipReferenceSet Obtiene un puntero de interfaz IOpcSignatureRelationshipReferenceSet.
IOpcSigningOptions::GetTimeFormat Obtiene el formato de la cadena recuperada por el método IOpcDigitalSignature::GetSigningTime.
IOpcSigningOptions::SetCertificateEmbeddingOption Establezca la ubicación de almacenamiento del certificado que se usará para la firma.
IOpcSigningOptions::SetDefaultDigestMethod Establece el método de resumen predeterminado que se usará para calcular los valores de resumen de los objetos que se van a firmar.
IOpcSigningOptions::SetSignatureId Establece el valor del atributo Id del elemento Signature. (IOpcSigningOptions.SetSignatureId)
IOpcSigningOptions::SetSignatureMethod Establece el método de firma que se va a usar para calcular y cifrar el valor hash del elemento SignedInfo, que se incluirá en el elemento SignatureValue de la firma.
IOpcSigningOptions::SetSignaturePartName Establece el nombre de parte de la parte de firma donde se almacenará el marcado de firma.
IOpcSigningOptions::SetTimeFormat Establece el formato de la cadena recuperada por el método IOpcDigitalSignature::GetSigningTime.

Comentarios

Para generar una firma, llame al método IOpcDigitalSignatureManager::Sign con el valor del parámetro signingOptions establecido en un puntero de interfaz IOpcSigningOptions .

Para crear un puntero de interfaz IOpcSigningOptions , llame al método IOpcDigitalSignatureManager::CreateSigningOptions .

El llamador debe establecer un valor predeterminado para el método de resumen y el método de firma antes de generar una firma. Para establecer un método de resumen predeterminado, llame al método SetDefaultDigestMethod . Para establecer un método de firma, llame al método SetSignatureMethod .

Para obtener un puntero de interfaz IOpcSignatureCustomObjectSet , llame al método GetCustomObjectSet . Los punteros de interfaz del conjunto representan elementos Object específicos de la aplicación.

Para obtener un puntero de interfaz IOpcSignatureReferenceSet , llame al método GetCustomReferenceSet . Los punteros de interfaz del conjunto representan referencias a elementos Object específicos de la aplicación o a sus elementos secundarios que se firmarán cuando se genere la firma.

La ubicación predeterminada del certificado es OPC_CERTIFICATE_IN_CERTIFICATE_PART. Para cambiar este valor, llame al método SetCertificateEmbeddingOption .

El formato predeterminado de la cadena de hora de firma es OPC_SIGNATURE_TIME_FORMAT_MILLISECONDS. Para cambiar el formato de la cadena de hora de firma, llame al método SetTimeFormat .

Seguridad para subprocesos

Los objetos de empaquetado no son seguros para subprocesos.

Para obtener más información, consulte el Introducción con packaging API.

Requisitos


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