IOpcSignaturePartReferenceSet ::Create, méthode (msopc.h)

Article
02/29/2024

Crée un pointeur d’interface IOpcSignaturePartReference qui représente une référence à un composant à signer et ajoute la nouvelle interface à l’ensemble.

Syntaxe

HRESULT Create(
  [in]          IOpcPartUri                 *partUri,
  [in]          LPCWSTR                     digestMethod,
  [in]          OPC_CANONICALIZATION_METHOD transformMethod,
  [out, retval] IOpcSignaturePartReference  **partReference
);

Paramètres

[in] partUri

IOpcPartUri qui représente le nom de la partie à référencer.

[in] digestMethod

Méthode digeste à utiliser pour une partie du contenu de la partie à référencer. Pour utiliser la méthode digeste par défaut, passez NULL à ce paramètre.

Important La méthode digest par défaut doit être définie en appelant la méthode IOpcSigningOptions ::SetDefaultDigestMethod avant d’appeler IOpcDigitalSignatureManager ::Sign .

[in] transformMethod

Méthode de canonisation utilisée pour le contenu d’une partie du composant à référencer.

[out, retval] partReference

Nouveau pointeur d’interface IOpcSignaturePartReference qui représente la référence au composant à signer.

Ce paramètre peut avoir la valeur NULL si un pointeur vers la nouvelle interface n’est pas nécessaire.

Valeur retournée

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

Code de retour	Description
S_OK	S_OK
E_INVALIDARG	La valeur transmise dans le paramètre transformMethod n’est pas une valeur d’énumération OPC_CANONICALIZATION_METHOD valide.
E_POINTER	Le paramètre partUri est NULL.

Remarques

Seules les parties qui peuvent être représentées par l’interface IOpcPart peuvent être référencées par un pointeur d’interface IOpcSignaturePartReference . Les parties de relations sont référencées pour la signature par un pointeur vers l’interface IOpcSignatureRelationshipReference . Pour créer un pointeur d’interface IOpcSignatureRelationshipReference , appelez la méthode IOpcSignatureRelationshipReferenceSet ::Create .

Lorsqu’un pointeur d’interface IOpcSignaturePartReference est créé et ajouté au jeu, la référence qu’il représente est enregistrée lors de l’enregistrement du package.

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