Méthode IOpcFactory ::CreateDigitalSignatureManager (msopc.h)

Article
11/11/2023

Crée un objet de gestionnaire de signature numérique pour un objet de package.

Syntaxe

HRESULT CreateDigitalSignatureManager(
  [in]          IOpcPackage                 *package,
  [out, retval] IOpcDigitalSignatureManager **signatureManager
);

Paramètres

[in] package

Pointeur vers l’interface IOpcPackage de l’objet package à associer à l’objet gestionnaire de signature numérique.

[out, retval] signatureManager

Pointeur vers l’interface IOpcDigitalSignatureManager de l’objet de gestionnaire de signature numérique créé pour une utilisation avec l’objet package.

Un objet de gestionnaire de signature numérique permet d’accéder aux interfaces et méthodes de signature numérique de l’API Packaging. Ils peuvent être utilisés pour signer le package représenté par l’objet package ou pour valider les signatures dans un package qui a déjà été signé.

Valeur retournée

Cette méthode retourne un code HRESULT. Les valeurs possibles sont notamment celles figurant dans le tableau suivant.

Code/valeur de retour	Description
S_OK	S_OK
E_NOTIMPL	Cette méthode n’est pas implémentée pour cette version de Windows.
OPC_E_DS_DUPLICATE_SIGNATURE_ORIGIN_RELATIONSHIP 0x8051001B	Il existe plusieurs relations du type de relation d’origine de signature numérique, mais une seule de ces relations est autorisée. Pour plus d’informations sur ce type de relation, consultez OPC.
OPC_E_DS_INVALID_SIGNATURE_ORIGIN_RELATIONSHIP 0x8051001C	Une relation de package de type signature numérique d’origine cible un emplacement externe au package. Les composants Digital Signature Origin doivent se trouver en interne. Pour plus d’informations sur ce type de relation, consultez OPC.
OPC_E_DS_MISSING_SIGNATURE_ORIGIN_PART 0x8051001F	Une relation d’origine de type signature numérique a été trouvée, mais la partie Origine de signature numérique elle-même ne l’était pas. Pour plus d’informations sur ce type de relation, consultez OPC.

Remarques

Si un package est modifié pendant que des interfaces de signature numérique d’empaquetage sont utilisées pour signer le package, la signature peut échouer ou entraîner une signature ou un package incohérent.

Prise en charge sur les versions précédentes de Windows

Cette méthode n’est pas prise en charge sur les versions de Windows antérieures à Windows 7. Pour plus d’informations, consultez Prise en main avec l’API d’empaquetage et Mise à jour de plateforme pour Windows Vista.

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 Packaging.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	msopc.h