IUIAnimationManager::GetVariableFromTag method (uianimation.h)

Gets the animation variable with the specified tag.


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


[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.


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.


Minimum supported client Windows 7, Windows Vista and Platform Update for Windows Vista [desktop apps | UWP apps]
Minimum supported server None supported
Target Platform Windows
Header uianimation.h
DLL UIAnimation.dll

See also