IOpcRelationshipSelector::GetSelectionCriterion-Methode (msopc.h)

Artikel
08/25/2023

Ruft eine Zeichenfolge ab, die zum Auswählen von Beziehungen verwendet wird, auf die beim Signieren verwiesen werden soll.

Syntax

HRESULT GetSelectionCriterion(
  [out, retval] LPWSTR *selectionCriterion
);

Parameter

[out, retval] selectionCriterion

Eine Zeichenfolge, die verwendet wird, um Beziehungen auszuwählen, auf die beim Signieren verwiesen werden soll.

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 selectionCriterion-Parameter ist NULL.

Hinweise

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

Verwenden Sie die IOpcRelationshipSelector-Schnittstellenmethoden , um Beziehungen zum Signieren auszuwählen. Eine Beziehung wird ausgewählt, wenn ihr Typ oder Bezeichner mit der Zeichenfolge übereinstimmt, die durch Aufrufen der GetSelectionCriterion-Methode abgerufen wird. Diese Zeichenfolge ist entweder ein Beziehungstyp oder ein Beziehungsbezeichner. Rufen Sie die GetSelectorType-Methode auf, um einen OPC_RELATIONSHIP_SELECTOR Wert abzurufen, um zu bestimmen, ob die Zeichenfolge ein Beziehungstyp oder ein Bezeichner ist. Um auf diese Beziehungseigenschaften zuzugreifen, rufen Sie die Methoden IOpcRelationship::GetRelationshipType und IOpcRelationship::GetId auf .

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