IOpcPartSet::GetPart-Methode (msopc.h)

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

Weitere Informationen

Erste Schritte mit der Verpackungs-API

IOpcPartSet

Übersichten

Verpackungs-API-Referenz

Beispiele für die Paket-API

Paketerstellungsfehler

Teileübersicht

Referenz