Поделиться через

Функция PeerGraphPeerTimeToUniversalTime (p2p.h)

  • Статья

Функция PeerGraphPeerTimeToUniversalTime преобразует значение времени, поддерживаемое графиком одноранговых узлов, в локализованное значение времени, подходящее для отображения на компьютере однорангового узла.

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphPeerTimeToUniversalTime(
  [in]  HGRAPH   hGraph,
  [in]  FILETIME *pftPeerTime,
  [out] FILETIME *pftUniversalTime
);

Параметры

[in] hGraph

Дескриптор однорангового графа, в который участвует этот одноранговый узел. Этот дескриптор возвращается функцией PeerGraphCreate или PeerGraphOpen .

[in] pftPeerTime

Указатель на значение времени однорангового узла (UTC), представленное в виде структуры FILETIME .

[out] pftUniversalTime

Указатель на возвращаемое универсальное значение времени, представленное в виде структуры FILETIME .

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

Возвращает S_OK, если функция выполнена успешно; В противном случае функция возвращает одно из следующих значений.

Код возврата Описание
E_INVALIDARG
 Один из параметров недопустим.
PEER_E_INVALID_GRAPH
 Недопустимый дескриптор графа.
PEER_E_NOT_INITIALIZED
 Перед использованием этой функции граф необходимо инициализировать с помощью вызова PeerGraphStartup .

Комментарии

Универсальное время — это время в формате UTC, производное от системных часов однорангового узла.

Время однорангового узла — это общее эталонное время, поддерживаемое одноранговым графом, выраженное как среднее время по Гринвичу.

Одноранговое время следует преобразовывать в универсальное время всякий раз, когда необходимо отобразить это значение на компьютере однорангового узла, например при отображении времени создания записи. Аналогичным образом, зависящие от времени действия, такие как установка срока действия для записи или поиск записей на основе времени изменения, должны использовать значения времени, преобразованные из универсального времени конкретного компьютера в одноранговое время для конкретного графа.

Универсальное время можно преобразовать в одноранговый узел, вызвав конверсивную функцию PeerGraphUniversalTimeToPeerTime.

Требования

Требование Значение
Минимальная версия клиента Windows XP с пакетом обновления 2 (SP2) [только классические приложения], Windows XP с пакетом обновления 1 (SP1) с дополнительным сетевым пакетом для Windows XP
Минимальная версия сервера Ни одна версия не поддерживается
Целевая платформа Windows
Header p2p.h
Библиотека P2PGraph.lib
DLL P2PGraph.dll

См. также раздел

PeerGraphUniversalTimeToPeerTime