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.