ITcSysManager::LinkVariables
Die LinkVariables()-Methode verknüpft zwei mit ihren Pfadnamen spezifizierte Variablen. Die Syntax der Pfadnamen muss der in LookupTreeItem beschriebenen Syntax entsprechen. Die Methode prüft, ob beide Items existieren, vom Typ Variable sind und kompatible Datentypen/Größen besitzen, und setzt anschließend das Mapping-Modified-Flag.
Signatur
HRESULT LinkVariables(BSTR bstrV1, BSTR bstrV2, long offs1, long offs2, long size);
Parameter
|
Name |
Typ |
Beschreibung |
|---|---|---|
|
bstrV1 |
BSTR |
[in] Pfadname der ersten Variablen. Der vollständige Pfadname ist erforderlich, jeder Zweig muss durch Zirkumflex |
|
bstrV2 |
BSTR |
[in] Pfadname der zweiten Variablen. Gleiche Syntax wie bei |
|
offs1 |
long |
[in, defaultvalue(0)] Bit-Offset der ersten Variablen (verwendet, wenn die Variablen unterschiedlicher Größe sind oder nur ein Teil verknüpft werden soll). |
|
offs2 |
long |
[in, defaultvalue(0)] Bit-Offset der zweiten Variablen. |
|
size |
long |
[in, defaultvalue(0)] Anzahl der zu verknüpfenden Bits. Bei |
Rückgabewert
|
Name |
Typ |
Beschreibung |
|---|---|---|
|
(HRESULT) |
HRESULT |
|
Fehlercodes
-
TSM_E_ITEMNOTFOUND: einer der Pfadnamen konnte nicht aufgelöst werden. -
TSM_E_INVALIDITEMTYPE: ein referenziertes Item ist keine Variable. -
TSM_E_MISMATCHINGITEMS: die Variablen sind nicht miteinander kompatibel (Typ/Größe). -
E_ACCESSDENIED: System Manager ist deaktiviert.
Siehe auch
- LookupTreeItem: Pfadnamen-Syntax
- UnlinkVariables: Verknüpfung wieder lösen