Функция RtlTimeToSecondsSince1970


[Функция RtlTimeToSecondsSince1970 доступна для использования в только Windows 2000 и Windows XP. Она может быть изменена или недоступна в последующих версиях.]

Функция RtlTimeToSecondsSince1970 преобразует заданное 64-битовое системное время в число секунд с начала от 1 января 1970.

Синтаксис

BOOLEAN RtlTimeToSecondsSince1970(
  PLARGE_INTEGER Time,
  PULONG ElapsedSeconds
);
 

Параметры

Time

[in] Указатель на заданное системное время. Допустимые годы для этого значения 1970 - 2105 включительно.

ElapsedSeconds

[out] Указатель на переменную, который получает число секунд.

Возвращаемые значения

Если функция завершается успешно, то возвращается значение TRUE. Если она завершается ошибкой, то возвращается значение FALSE. Как правило, эта функция завершается ошибкой, если заданное значение параметра Time не будет в пределах допустимого периода, указанного в описании этого параметра.

Замечания

У этой функции нет ассоциированной библиотеки импорта. Вы должны использовать функции LoadLibrary и GetProcAddress, чтобы динамически связаться с библиотекой Ntdll.dll.

Это не единственная эквивалентная общедоступная функция. Чтобы выполнить эту задачу, используя общедоступные функции, сделайте нижеследующие шаги:

  1. Вызовите функцию SystemTimeToFileTime, чтобы скопировать системное время в структуру FILETIME. Вызовите функцию GetSystemTime, чтобы заставить время текущей операционной системы передать в SystemTimeToFileTime.
  2. Скопируйте содержимое структуры FILETIME в структуру ULARGE_INTEGER.
  3. Инициализируйте структуру SYSTEMTIME датой и временем первой секунды от 1 января 1970.
  4. Вызовите SystemTimeToFileTime, передав структуру SYSTEMTIME, инициализированную в шаге 3 при её вызове.
  5. Скопируйте содержимое структуры FILETIME, возвращенное функцией SystemTimeToFileTime в шаге 4 во вторую структуру ULARGE_INTEGER. Скопированное значение должно быть больше чем или равно значению, скопированному в шаге 2.
  6. Вычтите 64-битовое значение в структуре ULARGE_INTEGER, инициализированной в шаге 2 из 64-битового значения структуры ULARGE_INTEGER, инициализированной в шаге 5. Это создает значение в интервалах по 100 наносекунд с 1 января 1970. Чтобы преобразовать это значение в секунды, разделите его на 10 000 000.

Смотри также

Обзор Время (операционной системы), Функции, используемые для времени, SystemTimeToFileTime, FILETIME, SYSTEMTIME, ULARGE_INTEGER

Размещение и совместимость RtlTimeToSecondsSince1970
К Windows XP Да
л Windows 2000 Professional Да
и Windows NT Workstation Нет
е Windows Me Нет
н Windows 98 Нет
т Windows 95 Нет
 
С Windows Server 2003 Да
е Windows 2000 Server Да
р Windows NT Server Нет
в    
е    
р    
Используемая библиотека -
Используемая DLL ntdll.dll
Заголовочный файл  
- объявлено в Winternl.h
- включено в -
Unicode Нет
Замечания по платформе Не имеется

 

Назад в оглавление
На главную страницу
На оглавление справки

Hosted by uCoz