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

Статья
03/01/2024

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

Синтаксис

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

Параметры

[in] hGroup

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

[in] pftUniversalTime

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

[out] pftPeerTime

Указатель на возвращаемое одноранговое время — среднее по Гринвичу время (GMT), представленное в виде структуры FILETIME . Этот параметр имеет значение NULL , если возникает ошибка.

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

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

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

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

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

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

Требования

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

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

PeerGroupPeerTimeToUniversalTime

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