Méthode IOpcPartSet ::D eletePart (msopc.h)

Article
03/13/2024

Supprime du jeu le pointeur d’interface IOpcPart d’un objet de composant spécifié.

Syntaxe

HRESULT DeletePart(
  [in] IOpcPartUri *name
);

Paramètres

[in] name

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

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	La partie spécifiée n’existe pas.
Erreur de consommation de package	Un code d’erreur HRESULT du groupe d’erreurs de consommation de package.
Erreur d’URI de composant	Code d’erreur HRESULT du groupe d’erreurs d’URI de composant.

Remarques

Lorsqu’un pointeur d’interface IOpcPart est supprimé du jeu, la partie qu’il représente n’est pas sérialisée lorsque le package est sérialisé. En outre, si la partie représentée est la source d’une ou plusieurs relations, ces relations ne sont pas enregistrées avec le package lorsque l’objet de package est écrit.

Les données contenues dans un objet de composant supprimé sont accessibles jusqu’à ce que l’objet de package qui contient l’objet de composant supprimé soit libéré. En outre, une relation dont la source est la partie représentée par l’objet de composant supprimé reste également accessible jusqu’à ce que l’objet de package qui contient l’objet de composant supprimé soit libéré. Toutefois, ces relations ne sont pas enregistrées 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