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

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

  • Статья

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