通过

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 将对等时间转换为通用时间。

要求

要求 值
最低受支持的客户端 具有 SP2 的 Windows XP [仅限桌面应用]，具有 SP1 的 Windows XP 与高级网络包 forWindows XP
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 p2p.h
Library P2P.lib
DLL P2P.dll

另请参阅

PeerGroupPeerTimeToUniversalTime