IOpcPartSet ::CreatePart, méthode (msopc.h)

Article
03/04/2024

Crée un objet de composant qui représente un composant et ajoute un pointeur vers l’interface IOpcPart de l’objet à l’ensemble.

Syntaxe

HRESULT CreatePart(
  [in]          IOpcPartUri             *name,
  [in]          LPCWSTR                 contentType,
  [in]          OPC_COMPRESSION_OPTIONS compressionOptions,
  [out, retval] IOpcPart                **part
);

Paramètres

[in] name

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

Pour créer un objet URI de composant (qui implémente l’interface IOpcPartUri ) afin de représenter le nom de la partie, appelez la méthode IOpcFactory ::CreatePartUri .

[in] contentType

Type de média du contenu de composant.

[in] compressionOptions

Valeur qui décrit la façon de compresser le contenu du composant.

[out, retval] part

Pointeur vers le nouvel IOpcPart qui représente le composant.

Ce paramètre ne peut pas être NULL.

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.
E_INVALIDARG	La valeur passée dans le paramètre compressionOptions n’est pas une valeur d’énumération OPC_COMPRESSION_OPTIONS valide.
OPC_E_DUPLICATE_PART 0x8051000B	Un composant portant le nom de composant spécifié existe déjà dans le package actuel.
OPC_E_INVALID_CONTENT_TYPE 0x80510044	Un type de contenu n’est pas conforme aux règles d’un type de média valide, spécifié dans RFC 2616 : HTTP/1.1 (http://www.w3.org/Protocols/rfc2616/rfc2616.html)et opc).
OPC_E_UNEXPECTED_CONTENT_TYPE 0x80510005	Soit le type de contenu d’une partie diffère du type de contenu attendu (spécifié dans l’OPC, ECMA-376 Partie 2), soit le contenu du composant ne correspond pas au type de contenu du composant.
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 objet de composant est créé et qu’un pointeur vers celui-ci est ajouté à l’ensemble, la partie qu’il représente est sérialisée lorsque le package est sérialisé.

Cette méthode ne peut pas créer un objet de composant qui représente une partie Relations.

Si le contenu du composant est compressé avant la création de l’objet de composant, transmettez la valeur OPC_COMPRESSION_NONE dans le paramètre compressionOptions .

Le contenu d’une partie déjà compressé ne compresse pas beaucoup plus.

Un IOpcPart permet d’accéder aux propriétés d’un composant. Pour plus d’informations sur ces propriétés, consultez la rubrique 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 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