IOpcPartSet::CreatePart-Methode (msopc.h)

Artikel
10/26/2023

Erstellt ein Part-Objekt, das ein Teil darstellt, und fügt dem Satz einen Zeiger auf die IOpcPart-Schnittstelle des Objekts hinzu.

Syntax

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

Parameter

[in] name

Ein Zeiger auf die IOpcPartUri-Schnittstelle eines Part-URI-Objekts, das den Teilenamen des Teils darstellt.

Um ein Part-URI-Objekt zu erstellen (das die IOpcPartUri-Schnittstelle implementiert), um den Teilenamen des Teils darzustellen, rufen Sie die IOpcFactory::CreatePartUri-Methode auf.

[in] contentType

Der Medientyp des Teileinhalts.

[in] compressionOptions

Ein Wert, der beschreibt, wie der Teileinhalt des Teils komprimiert werden kann.

[out, retval] part

Ein Zeiger auf das neue IOpcPart , das das Teil darstellt.

Dieser Parameter darf nicht NULL sein.

Rückgabewert

Die Methode gibt ein HRESULT zurück. Mögliches Werte (aber nicht die Einzigen) sind die in der folgenden Tabelle.

Rückgabecode/-wert	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_POINTER	Der name-Parameter ist NULL.
E_INVALIDARG	Der im compressionOptions-Parameter übergebene Wert ist kein gültiger OPC_COMPRESSION_OPTIONS Enumerationswert.
OPC_E_DUPLICATE_PART 0x8051000B	Ein Teil mit dem angegebenen Teilenamen ist bereits im aktuellen Paket vorhanden.
OPC_E_INVALID_CONTENT_TYPE 0x80510044	Ein Inhaltstyp entspricht nicht den Regeln für einen gültigen Medientyp, die in RFC 2616: HTTP/1.1 (http://www.w3.org/Protocols/rfc2616/rfc2616.html) und OPC) angegeben sind.
OPC_E_UNEXPECTED_CONTENT_TYPE 0x80510005	Entweder unterschied sich der Inhaltstyp eines Teils vom erwarteten Inhaltstyp (angegeben in OPC, ECMA-376 Part 2), oder der Teilinhalt entsprach nicht dem Inhaltstyp des Teils.
Fehler "Paketverbrauch"	Ein HRESULT-Fehlercode aus der Fehlergruppe Paketverbrauch.
Part-URI-Fehler	Ein HRESULT-Fehlercode aus der Part-URI-Fehlergruppe.

Hinweise

Wenn ein Teilobjekt erstellt und der Gruppe ein Zeiger darauf hinzugefügt wird, wird der teil, den es darstellt, serialisiert, wenn das Paket serialisiert wird.

Diese Methode kann kein Part-Objekt erstellen, das einen Relationships-Teil darstellt.

Wenn der Teileinhalt vor der Erstellung des Teilobjekts komprimiert wird, übergeben Sie den wert OPC_COMPRESSION_NONE im compressionOptions-Parameter .

Teileinhalte, die bereits komprimiert sind, werden nicht wesentlich mehr komprimiert.

Ein IOpcPart ermöglicht den Zugriff auf die Eigenschaften eines Teils. Ausführliche Informationen zu diesen Eigenschaften finden Sie in der Teileübersicht und im Thema IOpcPart .

Threadsicherheit

Das Packen von Objekten ist nicht threadsicher.

Weitere Informationen finden Sie im Erste Schritte mit der Verpackungs-API.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 7 [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 R2 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	msopc.h