Partager via


Interface IOpcSigningOptions (msopc.h)

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

Voir aussi

Principales interfaces d’empaquetage

Vue d’ensemble des signatures numériques

Prise en main avec l’API d’empaquetage

IOpcDigitalSignature

IOpcDigitalSignatureManager

Vues d'ensemble

Guide de programmation de l’API d’empaquetage

Informations de référence sur l’API d’empaque

Exemples d’API d’empaquetage

Empaquetage des interfaces de signature numérique

Interfaces d’empaquetage

Référence