PeerGroupPeerTimeToUniversalTime 函数 (p2p.h)

PeerGroupPeerTimeToUniversalTime 函数将对等组维护的引用时间值转换为适合在对等计算机上显示的本地化时间值。

语法

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

参数

[in] hGroup

对等方参与的对等组的句柄。 此句柄由 PeerGroupCreatePeerGroupOpenPeerGroupJoin 函数返回。 此参数是必需的。

[in] pftPeerTime

指向表示为 FILETIME 结构的对等时间值(协调世界时 (UTC) )的指针。 此参数是必需的。

[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 转换为对等时间

要求

要求
最低受支持的客户端 带 SP2 的 Windows XP [仅限桌面应用],带 SP1 的 Windows XP 以及适用于 Windows XP 的高级网络包
最低受支持的服务器 无受支持的版本
目标平台 Windows
标头 p2p.h
Library P2P.lib
DLL P2P.dll

另请参阅

PeerGroupUniversalTimeToPeerTime