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

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

  • Статья

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

Синтаксис

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupPeerTimeToUniversalTime(
  [in]  HGROUP   hGroup,
  [in]  FILETIME *pftPeerTime,
  [out] FILETIME *pftUniversalTime
);

Параметры

[in] hGroup

Дескриптор одноранговой группы, в которую участвует одноранговый узел. Этот дескриптор возвращается функцией PeerGroupCreate, PeerGroupOpen или PeerGroupJoin . Это обязательный параметр.

[in] pftPeerTime

Указатель на значение времени однорангового узла — время в формате UTC, представленное в виде структуры FILETIME . Это обязательный параметр.

[out] pftUniversalTime

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

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

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

Код возврата Описание
E_INVALIDARG
 Один из параметров недопустим.
PEER_E_GROUP_NOT_READY
 Одноранговая группа не находится в состоянии, когда время однорангового узла можно получить точно, например, был вызван PeerGroupJoin , но синхронизация с базой данных группы не завершена.
PEER_E_NOT_INITIALIZED
 Группа одноранговых узлов должна быть инициализирована вызовом PeerGroupStartup перед использованием этой функции.
 

Ошибки, связанные с шифрованием, могут быть возвращены базовым поставщиком Microsoft RSA. Эти ошибки имеют префикс CRYPT_* и определяются в Winerror.h.

Комментарии

Универсальное время — это универсальное значение времени, поддерживаемое на одноранговом компьютере.

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

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

Требования

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

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

PeerGroupUniversalTimeToPeerTime