IConsoleNameSpace::GetChildItem

[This is preliminary documentation and subject to change.]

Enables the snap-in to get the handle of a child item in the scope view pane.

HRESULT GetChildItem(
  HSCOPEITEM item,          // Handle to parent item
  HSCOPEITEM * pItemChild,  // Pointer to new handle address
  long * plCookie           // Pointer to new cookie address
);
 

Parameters

item

[in] Handle of a parent item in the scope pane

pItemChild

[out] Pointer to the handle identifying the new child item in the scope pane that has been returned.

plCookie

[out] Pointer to the cookie associated with the new child item that has been returned.

Return Values

S_OK

The child item was successfully retrieved.

E_UNEXPECTED

An unexpected error occurred.

Remarks

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

See Also

IConsoleNameSpace