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

Artigo
08/25/2023

Cria um objeto part que representa uma parte e adiciona um ponteiro à interface IOpcPart do objeto ao conjunto.

Sintaxe

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

Parâmetros

[in] name

Um ponteiro para a interface IOpcPartUri de um objeto URI de parte que representa o nome da parte.

Para criar um objeto URI de parte (que implementa a interface IOpcPartUri ) para representar o nome da parte, chame o método IOpcFactory::CreatePartUri .

[in] contentType

O tipo de mídia do conteúdo da parte.

[in] compressionOptions

Um valor que descreve a maneira de compactar o conteúdo da parte da parte.

[out, retval] part

Um ponteiro para o novo IOpcPart que representa a parte.

Esse parâmetro não pode ser NULL.

Retornar valor

O método retorna um HRESULT. Os possíveis valores incluem, mas sem limitação, aqueles na tabela a seguir.

Valor/código retornado	Descrição
S_OK	O método foi bem-sucedido.
E_POINTER	O parâmetro name é NULL.
E_INVALIDARG	O valor passado no parâmetro compressionOptions não é válido OPC_COMPRESSION_OPTIONS valor de enumeração.
OPC_E_DUPLICATE_PART 0x8051000B	Uma parte com o nome da parte especificada já existe no pacote atual.
OPC_E_INVALID_CONTENT_TYPE 0x80510044	Um tipo de conteúdo não está em conformidade com as regras de um tipo de mídia válido, especificado em RFC 2616: HTTP/1.1 (http://www.w3.org/Protocols/rfc2616/rfc2616.html) e o OPC.
OPC_E_UNEXPECTED_CONTENT_TYPE 0x80510005	O tipo de conteúdo de uma parte difere do tipo de conteúdo esperado (especificado no OPC, ECMA-376 Parte 2) ou o conteúdo da parte não correspondeu ao tipo de conteúdo da parte.
Erro de consumo de pacote	Um código de erro HRESULT do Grupo de Erros de Consumo de Pacote.
Erro de parte do URI	Um código de erro HRESULT do Grupo de Erros do URI da Parte.

Comentários

Quando um objeto part é criado e um ponteiro para ele é adicionado ao conjunto, a parte que ele representa é serializada quando o pacote é serializado.

Esse método não pode criar um objeto part que represente uma parte Relationships.

Se o conteúdo da parte for compactado antes da criação do objeto part, passe o valor OPC_COMPRESSION_NONE no parâmetro compressionOptions .

O conteúdo de parte que já está compactado não será compactado significativamente mais.

Uma IOpcPart fornece acesso às propriedades de uma parte. Para obter detalhes sobre essas propriedades, consulte o tópico Visão geral de partes e IOpcPart .

Acesso thread-safe

Os objetos de empacotamento não são thread-safe.

Para obter mais informações, consulte o Introdução com a API de Empacotamento.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 7 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2008 R2 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	msopc.h