# RTC_GetTime

## C Specification

  `#include <nitro/rtc.h>`

      RTCResult RTC_GetTime( RTCTime* time );

## Description

This function reads time data from the real time clock. It queries ARM7 for time data and returns the information once it is received. This is a synchronous version of `RTC_GetTimeAsync`.

## Cautions

This function requires a PXI interrupt for synchronization. It cannot be used in situations where PXI interrupts are prohibited. The RTC alarm interrupt permission status must be "enable" for this function to work properly with the real time clock. If the status is not "enable," the function returns an error.

## Arguments

`time` | Pointer to `RTCTime`. Time information is stored here upon return.

## Return Values

If the request succeeds, it returns 0.
If the request fails, it returns some numeric value other than 0.

## See Also

`RTC_GetTimeAsync, RTC_SetTime, RTC_SetTimeAsync, RTCResult, RTCTime`

## Revision History

05/18/2004 Initial Version