IOpcRelationship::GetId-Methode (msopc.h)

Artikel
02/29/2024

Ruft den eindeutigen Bezeichner der Beziehung ab.

Syntax

HRESULT GetId(
  [out, retval] LPWSTR *relationshipIdentifier
);

Parameter

[out, retval] relationshipIdentifier

Der Bezeichner der Beziehung.

Der Bezeichner einer Beziehung ist willkürlich und lokal für das Paket, und daher .

Gültige Bezeichner entsprechen den Einschränkungen für xsd:ID, die in Abschnitt 3.3.8 id der W3C-Empfehlung, XML Schema Part 2: Datatypes Second Edition (http://www.w3.org/TR/xmlschema-2/#ID) dokumentiert sind.

Rückgabewert

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

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode wurde erfolgreich ausgeführt.
E_POINTER	Der parameter relationshipIdentifier ist NULL.

Hinweise

Der Bezeichner einer Beziehung ist für die Suche nach Beziehungen nicht nützlich, da er willkürlich und lokal für das Paket ist.

Die endgültige Möglichkeit, einen Teil von Interesse zu finden, ist die Verwendung eines Beziehungstyps.

Die Suche nach einem Teil erfordert mehrere Schritte. Ausführliche Informationen zum Suchen eines Teils finden Sie unter Suchen des Kerneigenschaftenparts.

Diese Methode ordnet Arbeitsspeicher zu, der von der in relationshipIdentifier zurückgegebenen Zeichenfolge verwendet wird. Wenn die Methode erfolgreich ist, rufen Sie die CoTaskMemFree-Funktion auf, um den Arbeitsspeicher freizugeben.

Weitere Informationen zu Beziehungen finden Sie unter Open Packaging Conventions Fundamentals und ecma-376 OpenXML, 1st Edition, Part 2: Open Packaging Conventions (OPC).

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