IOpcPartSet::GetPart-Methode (msopc.h)

Artikel
02/29/2024

Ruft ein Teilobjekt ab, das ein angegebenes Teil darstellt, in der Gruppe.

Syntax

HRESULT GetPart(
  [in]          IOpcPartUri *name,
  [out, retval] IOpcPart    **part
);

Parameter

[in] name

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

[out, retval] part

Ein Zeiger auf das IOpcPart des Part-Objekts, das das Teil darstellt, das den angegebenen Teilenamen aufweist.

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 "Paketverbrauch"	Ein HRESULT-Fehlercode aus der Fehlergruppe Paketverbrauch.
Part-URI-Fehler	Ein HRESULT-Fehlercode aus der Part-URI-Fehlergruppe.

Hinweise

Um den IOpcPart-Schnittstellenzeiger des Part-Objekts abzurufen, das ein bestimmtes Teil darstellt, rufen Sie die PartExists-Methode auf, und übergeben Sie den Teilenamen, um zu bestätigen, dass das Teil im Satz dargestellt ist. Wenn dies der Grund ist, rufen Sie die GetPart-Methode auf, und übergeben Sie den Teilenamen, um den IOpcPart-Schnittstellenzeiger abzurufen.

Wenn das Part-URI-Objekt den Teilenamen eines Relationships-Teils darstellt, schlägt diese Methode fehl, da Relationships-Teile nicht im Satz enthalten sind.

Die IOpcPart-Schnittstelle ermöglicht den Zugriff auf die Eigenschaften eines Teils. Ausführliche Informationen zu diesen Eigenschaften finden Sie unter Teileübersicht und 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