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

Статья
08/25/2023

Функция 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

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