Metodo IOpcPartSet::CreatePart (msopc.h)

Articolo
03/05/2024

Crea un oggetto part che rappresenta una parte e aggiunge un puntatore all'interfaccia IOpcPart dell'oggetto al set.

Sintassi

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

Parametri

[in] name

Puntatore all'interfaccia IOpcPartUri di un oggetto URI parte che rappresenta il nome della parte della parte.

Per creare un oggetto URI di parte (che implementa l'interfaccia IOpcPartUri ) per rappresentare il nome della parte della parte, chiamare il metodo IOpcFactory::CreatePartUri .

[in] contentType

Tipo di contenuto multimediale della parte.

[in] compressionOptions

Valore che descrive il modo per comprimere il contenuto della parte della parte.

[out, retval] part

Puntatore al nuovo IOpcPart che rappresenta la parte.

Questo parametro non può essere NULL.

Valore restituito

Il metodo restituisce un valore HRESULT. I valori possibili includono, ma non sono limitati a, quelli indicati nella tabella seguente.

Codice/valore restituito	Descrizione
S_OK	Il metodo è riuscito.
E_POINTER	Il parametro name è NULL.
E_INVALIDARG	Il valore passato nel parametro compressionOptions non è un valore di enumerazione OPC_COMPRESSION_OPTIONS valido.
OPC_E_DUPLICATE_PART 0x8051000B	Nel pacchetto corrente esiste già una parte con il nome della parte specificata.
OPC_E_INVALID_CONTENT_TYPE 0x80510044	Un tipo di contenuto non è conforme alle regole per un tipo di supporto valido, specificato in RFC 2616: HTTP/1.1 (http://www.w3.org/Protocols/rfc2616/rfc2616.html) e OPC.
OPC_E_UNEXPECTED_CONTENT_TYPE 0x80510005	Il tipo di contenuto di una parte è diverso dal tipo di contenuto previsto (specificato in OPC, ECMA-376 Parte 2) oppure il contenuto della parte non corrisponde al tipo di contenuto della parte.
Errore di consumo del pacchetto	Codice di errore HRESULT del gruppo di errori di consumo del pacchetto.
Errore dell'URI della parte	Codice di errore HRESULT del gruppo di errori URI parte.

Commenti

Quando viene creato un oggetto part e viene aggiunto un puntatore al set, la parte che rappresenta viene serializzata quando il pacchetto viene serializzato.

Questo metodo non può creare un oggetto part che rappresenta una parte Relationships.

Se il contenuto della parte viene compresso prima della creazione dell'oggetto parte, passare il valore OPC_COMPRESSION_NONE nel parametro compressionOptions .

Il contenuto della parte già compresso non comprimerà significativamente di più.

Un IOpcPart fornisce l'accesso alle proprietà di una parte. Per informazioni dettagliate su queste proprietà, vedere Cenni preliminari sulle parti e l'argomento IOpcPart .

Thread safety

I pacchetti degli oggetti non sono thread-safe.

Per altre informazioni, vedere l'Introduzione con l'API per la creazione di pacchetti.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 7 [solo app desktop]
Server minimo supportato	Windows Server 2008 R2 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	msopc.h