Método IOpcPartSet::CreatePart (msopc.h)

Artículo
02/29/2024

Crea un objeto part que representa un elemento y agrega un puntero a la interfaz IOpcPart del objeto al conjunto.

Sintaxis

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

Parámetros

[in] name

Puntero a la interfaz IOpcPartUri de un objeto URI de parte que representa el nombre de la parte del elemento.

Para crear un objeto de URI de parte (que implementa la interfaz IOpcPartUri ) para representar el nombre de elemento del elemento, llame al método IOpcFactory::CreatePartUri .

[in] contentType

Tipo de medio de contenido de parte.

[in] compressionOptions

Valor que describe la forma de comprimir el contenido de la pieza.

[out, retval] part

Puntero al nuevo IOpcPart que representa la parte.

Este parámetro no puede ser NULL.

Valor devuelto

El método devuelve un valor HRESULT. Entre los valores posibles se incluyen los que se indican en la tabla siguiente, entre otros.

Código o valor devuelto	Descripción
S_OK	El método se ha llevado a cabo de forma correcta.
E_POINTER	El parámetro name es NULL.
E_INVALIDARG	El valor pasado en el parámetro compressionOptions no es un valor de enumeración OPC_COMPRESSION_OPTIONS válido.
OPC_E_DUPLICATE_PART 0x8051000B	Ya existe un elemento con el nombre de elemento especificado en el paquete actual.
OPC_E_INVALID_CONTENT_TYPE 0x80510044	Un tipo de contenido no se ajusta a las reglas de un tipo de medio válido, especificado en RFC 2616: HTTP/1.1 (http://www.w3.org/Protocols/rfc2616/rfc2616.html) y OPC.
OPC_E_UNEXPECTED_CONTENT_TYPE 0x80510005	El tipo de contenido de una parte difiere del tipo de contenido esperado (especificado en OPC, ECMA-376 Part 2) o el contenido de la parte no coincide con el tipo de contenido del elemento.
Error de consumo de paquetes	Código de error HRESULT del grupo de errores de consumo de paquetes.
Error de URI de parte	Código de error HRESULT del grupo de errores de URI de parte.

Comentarios

Cuando se crea un objeto de elemento y se agrega un puntero al conjunto, el elemento que representa se serializa cuando se serializa el paquete.

Este método no puede crear un objeto part que represente un elemento Relationships.

Si el contenido de la pieza se comprime antes de la creación del objeto de pieza, pase el valor OPC_COMPRESSION_NONE en el parámetro compressionOptions .

El contenido de la pieza que ya está comprimido no se comprimirá significativamente más.

IOpcPart proporciona acceso a las propiedades de una parte. Para obtener más información sobre estas propiedades, consulte el tema Información general sobre los elementos y IOpcPart .

Seguridad para subprocesos

Los objetos de empaquetado no son seguros para subprocesos.

Para más información, consulte la Introducción con la API de empaquetado.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 7 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2008 R2 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	msopc.h