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

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

  • Статья

Функция PeerGraphUniversalTimeToPeerTime преобразует универсальное значение времени с компьютера однорангового узла в общее значение времени однорангового графа.

Синтаксис

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

Параметры

[in] hGraph

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

[in] pftUniversalTime

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

[out] pftPeerTime

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

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

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

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

Комментарии

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

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

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

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

Требования

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

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

PeerGraphPeerTimeToUniversalTime