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

Article
02/29/2024

Crée un pointeur d’interface IOpcRelationshipSelector pour représenter la façon dont un sous-ensemble de relations est sélectionné pour être signé et ajoute le nouveau pointeur à l’ensemble.

Syntaxe

HRESULT Create(
  [in]          OPC_RELATIONSHIP_SELECTOR selector,
  [in]          LPCWSTR                   selectionCriterion,
  [out, retval] IOpcRelationshipSelector  **relationshipSelector
);

Paramètres

[in] selector

Valeur qui décrit comment interpréter la chaîne passée dans selectionCriterion.

[in] selectionCriterion

Chaîne interprétée pour produire un critère.

[out, retval] relationshipSelector

Nouveau pointeur d’interface IOpcRelationshipSelector qui représente la façon dont les relations sont sélectionnées à partir d’un composant Relations.

Ce paramètre peut être 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 passée dans le paramètre de sélecteur n’est pas une valeur d’énumération OPC_RELATIONSHIP_SELECTOR valide.
E_POINTER	Le paramètre partUri est NULL.

Remarques

Utilisez les méthodes des pointeurs d’interface IOpcRelationshipSelector dans l’ensemble pour sélectionner les relations à signer.

Lorsqu’un pointeur d’interface IOpcRelationshipSelector est créé et ajouté à l’ensemble, le critère auquel il fournit l’accès est enregistré 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 d’empaquetage.

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