# GetAsyncTimerAttribute

int GetAsyncTimerAttribute (int timerID, int timerAttribute, void *attributeValue);

## Purpose

This function gets the value of the specified attribute for the timer with the given ID.

The attributes that can be queried are the Interval, Count, Enabled, Callback Function, or Callback Data attributes.

## Parameters

Input
Name | Type | Description
timerID | integer | Specifies the ID of the timer for which you want to get the desired attribute. This is the value returned by a call to NewAsyncTimer.
timerAttribute | integer | The asynchronous timer attribute value to obtain. In the function panel, when you click the control or press <Enter>, <Spacebar>, or <Ctrl-down arrow>, a dialog box appears containing a hierarchical list of the available attributes. Attributes whose values cannot be obtained are dimmed. Help text is shown for each attribute. To select an attribute, double-click it or select it and then press <Enter>. If the attribute shown in this ring control has named constants as valid values, you can open a list of them by moving to the Attribute Value control and pressing <Enter>. The Attribute Values dialog box displays the values and value help for the constants.
attributeValue | void * | The value of the specified asynchronous timer attribute. If the attribute shown in this control has named constants as valid values, you can open a list of them by pressing <Enter>. The Attribute Values dialog box displays the values and value help for the constants.

## Return Value

Name | Type | Description
status | integer | Return value indicating whether the function was successful. A negative number indicates that an error occurred.
Return Values:
0 | Success.
–1 | The system failed to allocate a timer.
–2 | No more IDs are available to assign to a new timer.
–3 | Not enough memory left for this operation.
–4 | The timer with the given ID was not found.
–5 | Initialization with a call to NewAsyncTimer was not done.
–6 | An internal error occurred.
–7 | The value of a parameter passed to this function was invalid.