IConsoleNameSpace::GetParentItem

[This is preliminary documentation and subject to change.]

Enables the snap-in to retrieve the handle of a parent item in the scope view.

HRESULT GetParentItem(
  HSCOPEITEM item,           // Scope pane item handle
  HSCOPEITEM * pItemParent,  // Pointer to parent handle address
  long * plCookie            // Pointer to cookie's address
);
 

Parameters

item

[in] Handle of an item in the scope pane.

pItemParent

[out] Pointer to the handle of the parent item returned.

plCookie

[out] Pointer to the cookie associated with the item returned.

Return Values

S_OK

The parent item was successfully retrieved.

E_UNEXPECTED

An unexpected error occurred.

Remarks

If the handle of the parent item is not obtained, NULL is returned.

See Also

IConsoleNameSpace