IConsoleNameSpace::InsertItem

[This is preliminary documentation and subject to change.]

Enables the snap-in to insert a single item into the scope view.

HRESULT InsertItem(
  LPSCOPEDATAITEM item  // Pointer to a structure with item 
                        // attributes
);
 

Parameters

item

[in, out] Pointer to a SCOPEDATAITEM structure that specifies the attributes of the new scope pane item. On return, the ID member of the structure contains the scope-pane-assigned item identifier for the newly inserted item.

Return Values

S_OK

The item was successfully inserted.

E_UNEXPECTED

An unexpected error occurred.

E_INVALIDARG

The item parameter may be NULL, or the mask member of the SCOPEDATAITEM structure does not contain SDI_STR and SDI_PARAM, or the structure's displayname member is not equal to MMC_CALLBACK.

E_OUTOFMEMORY

The operation could not be completed due to lack of memory.

See Also

IConsoleNameSpace