ITcSmTreeItem::ImportChild

Imports a child item from the clipboard or a previously exported file.

HRESULT ImportChild(BSTRbstrFile, BSTRbstrBefore, VARIANT_BOOLbReconnect, BSTRbstrName, ITcSmTreeItem**pipItem);

Parameters

bstrFile

[in, defaultvalue(L"")] File name of the file from which the new child will be imported. If no file name specified (empty string) the child will be imported from the clipboard.

bstrBefore

[in, defaultvalue(L"")] If set, the parameter contains the name of another child item in front of which the new item should be inserted. If not set, the child will be appended at the end.

bReconnect

[in, defaultvalue(VARIANT_TRUE)] An optional flag that instructs the System Manager to try to reconnect the variables from the imported item to other variables in the configuration (by name).

bstrName

[in, defaultvalue(L"")] If set, overrides the child item name with its name in the import file.

pipItem

[out, retval] Points to the location of a ITcSmTreeItem interface pointer that receives the result.

Return Values

S_OK

function returns successfully.

NTE_NOT_FOUND (0x80090011)

the file can not be found/opened.

NTE_BAD_SIGNATURE (0x80090006)

the file does not contain a valid tree item.

TSM_E_MISMATCHINGITEMS (0x98510004)

the item in the file is not a valid child item.