ITcSmTreeItem::ImportChild
Importiert ein Kind aus einer XML-/XTI-Datei. Die Datei wird geladen, es wird geprüft, ob das geladene Item als Child oder gegebenenfalls als Sibling eingefügt werden darf, das Item wird eingefügt, Modified-Flags werden gesetzt, Variablen-IDs neu zugewiesen und bei Bedarf Mappings wiederhergestellt.
Signatur
HRESULT ImportChild(BSTR bstrFile, BSTR bstrBefore, VARIANT_BOOL bReconnect, BSTR bstrName, ITcSmTreeItem** pipItem);
Parameter
|
Name |
Typ |
Beschreibung |
|---|---|---|
|
bstrFile |
BSTR |
[in, defaultvalue(L"")] Datei, aus der importiert wird. |
|
bstrBefore |
BSTR |
[in, defaultvalue(L"")] Optionaler Cursorname, vor dem eingefügt wird. |
|
bReconnect |
VARIANT_BOOL |
[in, defaultvalue(-1)] Wenn nicht |
|
bstrName |
BSTR |
[in, defaultvalue(L"")] Optionaler neuer Name für das importierte Item. |
Rückgabewert
|
Name |
Typ |
Beschreibung |
|---|---|---|
|
pipItem |
ITcSmTreeItem** |
[out, retval] Importiertes Tree-Item. |
|
(HRESULT) |
HRESULT |
|
Fehlercodes
-
NTE_NOT_FOUND: es konnte kein importierbares Item erzeugt werden. -
TSM_E_ITEMNOTFOUND: der angegebenebstrBefore-Cursor wurde nicht gefunden. -
E_FAIL: XML-Laden, Klassenprüfung oder Einfügen ist fehlgeschlagen. Details stehen im COM-Fehlertext. -
E_ACCESSDENIED: die zugehörige Datei darf nicht bearbeitet werden. -
TSM_E_ITEMDELETED: das referenzierte Tree-Item ist nicht mehr gültig.