IOpcPartSet::D eletePart-Methode (msopc.h)

Artikel
02/29/2024

Löscht den IOpcPart-Schnittstellenzeiger eines angegebenen Teilobjekts aus dem Satz.

Syntax

HRESULT DeletePart(
  [in] IOpcPartUri *name
);

Parameter

[in] name

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

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.
OPC_E_NO_SUCH_PART 0x80510018	Der angegebene Teil ist nicht vorhanden.
Fehler beim Paketverbrauch	Ein HRESULT-Fehlercode aus der Fehlergruppe "Paketverbrauch".
Teil-URI-Fehler	Ein HRESULT-Fehlercode aus der Part-URI-Fehlergruppe.

Hinweise

Wenn ein IOpcPart-Schnittstellenzeiger aus dem Satz gelöscht wird, wird der teil, den er darstellt, nicht serialisiert, wenn das Paket serialisiert wird. Wenn der dargestellte Teil die Quelle einer oder mehrerer Beziehungen ist, werden diese Beziehungen beim Schreiben des Paketobjekts nicht im Paket gespeichert.

Auf die in einem gelöschten Teilobjekt enthaltenen Daten kann zugegriffen werden, bis das Paketobjekt, das das gelöschte Teilobjekt enthält, freigegeben wird. Darüber hinaus kann auch auf eine Beziehung zugegriffen werden, deren Quelle der teil ist, der durch das gelöschte Teilobjekt dargestellt wird, bis das Paketobjekt freigegeben wird, das das gelöschte Teilobjekt enthält. Diese Beziehungen werden jedoch nicht gespeichert, wenn das Paket gespeichert wird.

Threadsicherheit

Das Packen von Objekten ist nicht threadsicher.

Weitere Informationen finden Sie in der Erste Schritte mit der Paketerstellungs-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