IUIAnimationManager::GetVariableFromTag method (uianimation.h)

Gets the animation variable with the specified tag.

Syntax

HRESULT GetVariableFromTag(
  [in, optional] IUnknown             *object,
  [in]           UINT32               id,
  [out]          IUIAnimationVariable **variable
);

Parameters

[in, optional] object

The object portion of the tag. This parameter can be NULL.

[in] id

The identifier portion of the tag.

[out] variable

The animation variable that matches the specified tag, or NULL if no match is found.

Return value

If the method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code. See Windows Animation Error Codes for a list of error codes.

Remarks

A tag is a pairing of an integer identifier (id) with a COM object (object). An application can use tags to identify animation variables and storyboards. NULL is a valid object component of a tag; therefore, the object parameter can be NULL.

Tags are not necessarily unique; this method returns UI_E_AMBIGUOUS_MATCH if more than one animation variable exists with the specified tag.

Requirements

See also

IUIAnimationManager

IUIAnimationVariable

IUIAnimationVariable::GetTag

IUIAnimationVariable::SetTag