# IRdWidgetActivationRequest Interface Reference

Inherits IDispatch.

List of all members.

## Public Member Functions
HRESULT | GetTargetNodesCount ([out, retval]RtUlong *pCount)
HRESULT | GetTargetNodeName ([in]RtUlong pIndex,[out, retval] BSTR *pControlledNodeName)
HRESULT | AddTargetNode ([in]BSTR bControlledNode)
HRESULT | RemoveTargetNode ([in]BSTR bstrControlledNode)

## Detailed Description

- Widget activation request is used in widget automatic activation mechanism.
- Widget subsystem set this data object to widget node and tries to read widget match parameters.
- From widgets that don't fail to evaluate widget match parameters the best matching widget is selected.

## Member Function Documentation

HRESULT IRdWidgetActivationRequest::GetTargetNodesCount | ( | [out, retval] RtUlong * | pCount | ) |

Return count of nodes for which widget subsystem is trying to find widget.

Returns:
  pCount [out, retval] Count of widget nodes.

  standard HRESULT processing can be applied to returned value.

HRESULT IRdWidgetActivationRequest::GetTargetNodeName | ( | [in] RtUlong | pIndex,
|  | [out, retval] BSTR * | pControlledNodeName |
| ) |  |  |

Return node name.

Parameters:

  | pIndex | [in] Node index.

Returns:
  pControlledNodeName [out, retval] Returned node name.

  standard HRESULT processing can be applied to returned value.

HRESULT IRdWidgetActivationRequest::AddTargetNode | ( | [in] BSTR | bControlledNode | ) |

Add node to list of nodes.

Parameters:

  | bControlledNode | [in] Node name.

Returns:
  standard HRESULT processing can be applied to returned value.

HRESULT IRdWidgetActivationRequest::RemoveTargetNode | ( | [in] BSTR | bstrControlledNode | ) |

Remove node to list of nodes.

Parameters:

  | bControlledNode | [in] Node name.

Returns:
  standard HRESULT processing can be applied to returned value.