RegisterOutputCallbackInteractionContext function (interactioncontext.h)

Registers a callback to receive interaction events from an Interaction Context object.

Syntax

HRESULT RegisterOutputCallbackInteractionContext(
  [in]           HINTERACTIONCONTEXT                 interactionContext,
  [in]           INTERACTION_CONTEXT_OUTPUT_CALLBACK outputCallback,
  [in, optional] void                                *clientData
);

Parameters

[in] interactionContext

Handle to the Interaction Context.

[in] outputCallback

The callback function.

[in, optional] clientData

A pointer to an object that contains information about the client. The value typically points to the object for which the member function is called (this).

Return value

If this function succeeds, it returns S_OK.

Otherwise, it returns an HRESULT error code.

Remarks

Each instance of an Interaction Context is limited to one output callback. Registering a callback function overwrites any existing callback registration for the Interaction Context.

This function is typically called after the creation of an Interaction Context or when the Interaction Context is reassigned to another UI element.

Requirements

See also

INTERACTION_CONTEXT_OUTPUT

INTERACTION_CONTEXT_OUTPUT_CALLBACK

Interaction Context Functions