Interface IOpcSigningOptions (msopc.h)

Article
08/25/2023

Fournit des méthodes pour définir et accéder aux informations requises pour générer une signature.

Héritage

L’interface IOpcSigningOptions hérite de l’interface IUnknown. IOpcSigningOptions a également les types de membres suivants :

Méthodes

L’interface IOpcSigningOptions utilise ces méthodes.


IOpcSigningOptions::GetCertificateEmbeddingOption Obtient une valeur qui spécifie l’emplacement de stockage dans le package du certificat à utiliser pour la signature.
IOpcSigningOptions::GetCertificateSet Obtient un pointeur d’interface IOpcCertificateSet.
IOpcSigningOptions::GetCustomObjectSet Obtient une interface IOpcSignatureCustomObjectSet.
IOpcSigningOptions::GetCustomReferenceSet Obtient un pointeur d’interface IOpcSignatureReferenceSet.
IOpcSigningOptions::GetDefaultDigestMethod Obtient la méthode digest par défaut qui sera utilisée pour calculer les valeurs de synthèse des objets à signer.
IOpcSigningOptions::GetSignatureId Obtient la valeur de l’attribut Id de l’élément Signature.
IOpcSigningOptions::GetSignatureMethod Obtient la méthode de signature à utiliser pour calculer et chiffrer la valeur de hachage de l’élément SignedInfo, qui sera sérialisé en tant qu’élément SignatureValue de la signature.
IOpcSigningOptions::GetSignaturePartName Obtient le nom du composant de signature dans lequel le balisage de signature sera stocké.
IOpcSigningOptions::GetSignaturePartReferenceSet Obtient une interface IOpcSignaturePartReferenceSet.
IOpcSigningOptions::GetSignatureRelationshipReferenceSet Obtient un pointeur d’interface IOpcSignatureRelationshipReferenceSet.
IOpcSigningOptions::GetTimeFormat Obtient le format de la chaîne récupérée par la méthode IOpcDigitalSignature::GetSigningTime.
IOpcSigningOptions::SetCertificateEmbeddingOption Définissez l’emplacement de stockage du certificat à utiliser pour la signature.
IOpcSigningOptions::SetDefaultDigestMethod Définit la méthode digest par défaut qui sera utilisée pour calculer les valeurs de synthèse des objets à signer.
IOpcSigningOptions::SetSignatureId Définit la valeur de l’attribut Id de l’élément Signature. (IOpcSigningOptions.SetSignatureId)
IOpcSigningOptions::SetSignatureMethod Définit la méthode de signature à utiliser pour calculer et chiffrer la valeur de hachage de l’élément SignedInfo, qui sera contenue dans l’élément SignatureValue de la signature.
IOpcSigningOptions::SetSignaturePartName Définit le nom du composant de signature dans lequel le balisage de signature sera stocké.
IOpcSigningOptions::SetTimeFormat Définit le format de la chaîne récupérée par la méthode IOpcDigitalSignature::GetSigningTime.

Notes

Pour générer une signature, appelez la méthode IOpcDigitalSignatureManager::Sign avec la valeur du paramètre signingOptions définie sur un pointeur d’interface IOpcSigningOptions .

Pour créer un pointeur d’interface IOpcSigningOptions , appelez la méthode IOpcDigitalSignatureManager::CreateSigningOptions .

L’appelant doit définir une valeur par défaut pour la méthode digest et la méthode de signature avant de générer une signature. Pour définir une méthode digest par défaut, appelez la méthode SetDefaultDigestMethod . Pour définir une méthode de signature, appelez la méthode SetSignatureMethod .

Pour obtenir un pointeur d’interface IOpcSignatureCustomObjectSet , appelez la méthode GetCustomObjectSet . Les pointeurs d’interface dans l’ensemble représentent des éléments Object spécifiques à l’application.

Pour obtenir un pointeur d’interface IOpcSignatureReferenceSet , appelez la méthode GetCustomReferenceSet . Les pointeurs d’interface dans le jeu représentent des références à des éléments Object spécifiques à l’application ou à leurs enfants qui seront signés lors de la génération de la signature.

L’emplacement par défaut du certificat est OPC_CERTIFICATE_IN_CERTIFICATE_PART. Pour modifier cette valeur, appelez la méthode SetCertificateEmbeddingOption .

Le format par défaut de la chaîne d’heure de signature est OPC_SIGNATURE_TIME_FORMAT_MILLISECONDS. Pour modifier le format de la chaîne d’heure de signature, appelez la méthode SetTimeFormat .

Cohérence de thread

Les objets d’empaquetage ne sont pas thread-safe.

Pour plus d’informations, consultez la Prise en main avec l’API d’empaquetage.

Spécifications


Client minimal pris en charge	Windows 7 [applications de bureau \| Applications UWP]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau \| Applications UWP]
Plateforme cible	Windows
En-tête	msopc.h