IOpcRelationshipSelectorSet::Create-Methode (msopc.h)

Artikel
08/25/2023

Erstellt einen IOpcRelationshipSelector-Schnittstellenzeiger , der darstellt, wie eine Teilmenge von Beziehungen zum Signierten ausgewählt wird, und fügt dem Satz den neuen Zeiger hinzu.

Syntax

HRESULT Create(
  [in]          OPC_RELATIONSHIP_SELECTOR selector,
  [in]          LPCWSTR                   selectionCriterion,
  [out, retval] IOpcRelationshipSelector  **relationshipSelector
);

Parameter

[in] selector

Ein Wert, der beschreibt, wie die Zeichenfolge interpretiert wird, die in selectionCriterion übergeben wird.

[in] selectionCriterion

Eine Zeichenfolge, die interpretiert wird, um ein Kriterium zu liefern.

[out, retval] relationshipSelector

Ein neuer IOpcRelationshipSelector-Schnittstellenzeiger , der darstellt, wie Beziehungen aus einem Beziehungsteil ausgewählt werden.

Dieser Parameter kann NULL sein, wenn kein Zeiger auf die neue Schnittstelle erforderlich ist.

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_INVALIDARG	Der im Selektorparameter übergebene Wert ist kein gültiger OPC_RELATIONSHIP_SELECTOR Enumerationswert.
E_POINTER	Der partUri-Parameter ist NULL.

Hinweise

Verwenden Sie die Methoden der IOpcRelationshipSelector-Schnittstellenzeiger im Satz, um Beziehungen für die Signatur auszuwählen.

Wenn ein IOpcRelationshipSelector-Schnittstellenzeiger erstellt und dem Satz hinzugefügt wird, wird das Kriterium gespeichert, auf das er Zugriff gewährt, wenn das Paket gespeichert wird.

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