IOpcPartSet ::P artExists, méthode (msopc.h)

Article
02/29/2024

Obtient une valeur qui indique si un composant spécifié est représenté en tant qu’objet de composant dans le jeu.

Syntaxe

HRESULT PartExists(
  [in]          IOpcPartUri *name,
  [out, retval] BOOL        *partExists
);

Paramètres

[in] name

Pointeur vers un IOpcPartUri qui représente le nom de la partie.

[out, retval] partExists

Une des valeurs suivantes :

Value	Signification
TRUE	Un composant qui a le nom de composant spécifié est représenté dans le jeu.
FALSE	Un composant qui a le nom de composant spécifié n’est pas représenté dans l’ensemble.

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_POINTER	Le paramètre partExists est NULL.
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

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 le nom du composant représenté est le nom d’un composant Relations, partExists reçoit FALSE , car les parties Relations ne sont pas incluses dans l’ensemble.

Si un composant est représenté dans le jeu, il existe dans le package en cours de lecture ou dans le package à écrire.

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