Méthode IOpcPartSet ::GetPart (msopc.h)

Article
03/06/2024

Obtient un objet de partie, qui représente un composant spécifié, dans l’ensemble.

Syntaxe

HRESULT GetPart(
  [in]          IOpcPartUri *name,
  [out, retval] IOpcPart    **part
);

Paramètres

[in] name

Pointeur vers l’interface IOpcPartUri de l’objet URI de composant qui représente le nom de partie d’un composant.

[out, retval] part

Pointeur vers le IOpcPart de l’objet de composant qui représente la partie qui a le nom de composant spécifié.

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_POINTER	Le paramètre name est NULL.
OPC_E_NO_SUCH_PART 0x80510018	Le composant spécifié n’existe pas.
Erreur de consommation de package	Code d’erreur HRESULT du groupe d’erreurs de consommation de package.
Erreur d’URI de partie	Code d’erreur HRESULT du groupe d’erreurs d’URI de partie.

Remarques

Pour récupérer le pointeur d’interface IOpcPart de l’objet de composant qui représente un composant spécifique, appelez la méthode PartExists et transmettez le nom du composant pour confirmer que la partie est représentée dans l’ensemble. Si c’est le cas, appelez la méthode GetPart et transmettez le nom du composant pour récupérer le pointeur d’interface IOpcPart .

Si l’objet URI de composant représente le nom de partie d’un composant Relations, cette méthode échoue, car les parties Relations ne sont pas incluses dans l’ensemble.

L’interface IOpcPart permet d’accéder aux propriétés d’un composant. Pour plus d’informations sur ces propriétés, consultez Vue d’ensemble des composants et IOpcPart.

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