ITcSysManager::LookupTreeItem

Sucht im Projektbaum nach einem Element anhand seines Pfadnamens (z. B. TIID^Device 1^Box 1) und liefert das passende Tree-Item zurück. Unterstützt die Suche in verschachtelten Projekten. Bei Fehlern wird ein detaillierter IErrorInfo-Eintrag gesetzt.

Signatur

HRESULT LookupTreeItem(BSTR bstrItem, ITcSmTreeItem** pipItem);

Parameter

Name	Typ	Beschreibung
bstrItem	BSTR	[in] Pfadname oder Name des Tree-Items, getrennt durch Zirkumflex `^` oder Tabulator.

Rückgabewert

Name	Typ	Beschreibung
pipItem	ITcSmTreeItem**	[out, retval] Das aufgelöste Tree-Item.
(HRESULT)	HRESULT	`S_OK` bei Erfolg, sonst Fehlercode.

Fehlercodes

TSM_E_ITEMNOTFOUND: Pfad konnte nicht aufgelöst werden.
E_ACCESSDENIED: System Manager ist deaktiviert.

Siehe auch

ITcSysManager6::TryLookupTreeItem: nicht-werfende Variante
ITcSysManager3::LookupTreeItemById: Suche per ID
ITcSmTreeItem: Rückgabetyp