ITcSysManager::LookupTreeItem

Die LookupTreeItem()-Methode gibt einen ITcTreeItem-Zeiger eines Tree Items zurück, das mit seinem vollständigen Pfadnamen angegeben wird.

HRESULT LookupTreeItem(BSTRbstrItem, ITcSmTreeItem**pipItem);

Parameter

bstrItem

[in] Pfadname des von Ihnen gesuchten Tree Items. Der vollständige Pfadname ist erforderlich und jeder Zweig muss durch ein Zirkumflex ‚^’ oder Tabulatorzeichen getrennt sein. Eine Liste der Kurzformen der wichtigsten Tree Items wird unten angegeben.

pipItem

[out, retval] zeigt auf den Speicherort eines ITcSmTreeItem-Schnittstellenzeigers bei Rückgabe. Der Schnittstellenzeiger ermöglicht den Zugriff auf spezifische, zum Tree Item gehörige Methoden.

Rückgabewerte

S_OK

Funktion hat Wert erfolgreich zurückgegeben.

TSM_E_ITEMNOTFOUND (0x98510001)

der Pfadname verweist nicht auf ein bestehendes Tree Item.

Kurzformen

Auf die wichtigsten Tree Item, die in jeder Konfigurationsdatei bestehen, kann über Kurzformen zugegriffen werden. Diese Kurzformen sind sprachenneutral und erfordern weniger Speicherplatz:

"TIIC": shortcut for "I/O Configuration"
“TIID": shortcut for "I/O Configuration^I/O Devices" or "I/O Configuration" TAB "I/O Devices"
“TIRC": shortcut for "Real-Time Configuration"
“TIRR": shortcut for "Real-Time Configuration^Route Settings"
“TIRT": shortcut for " Real-Time Configuration^Additional Tasks" or " Real-Time Configuration" TAB "Additional Tasks"
“TIRS": shortcut for " Real-Time Configuration^Real-Time Settings" or " Real-Time Configuration" TAB "Real-Time Settings"
“TIPC": shortcut for "PLC Configuration"
“TINC": shortcut for "NC Configuration"
“TICC": shortcut for "CNC Configuration"
“TIAC": shortcut for "CAM Configuration"

Beispiel (C++):

ITcSmTreeItem* ipItem;

BSTR bstrItem = L"TIID^Device 1 (C1220)";

if ( SUCCEEDED(spTsm->LookupTreeItem( bstrItem, &ipItem ))
)

{

 // do anything with ipItem


 ipItem->Release();

}

Beispiel (VB): Dim ipItem As ITcSmTreeItem

set ipItem = spTsm.LookupTreeItem("TIID^Device 1 (C1220)")

' do anything with ipItem

Kommentare