通过

PeerGraphPeerTimeToUniversalTime 函数 (p2p.h)

  • 项目

PeerGraphPeerTimeToUniversalTime 函数将对等图维护的参考时间值转换为适合在对等计算机上显示的本地化时间值。

语法

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphPeerTimeToUniversalTime(
  [in]  HGRAPH   hGraph,
  [in]  FILETIME *pftPeerTime,
  [out] FILETIME *pftUniversalTime
);

参数

[in] hGraph

此对等方参与的对等图的句柄。 此句柄由 PeerGraphCreate 或 PeerGraphOpen 函数返回。

[in] pftPeerTime

指向对等时间的指针 (UTC) 值，表示为 FILETIME 结构。

[out] pftUniversalTime

指向返回的通用时间值的指针，表示为 FILETIME 结构。

返回值

如果函数成功，则返回S_OK;否则，函数将返回以下值之一。

返回代码 说明
E_INVALIDARG
 其中一个参数无效。
PEER_E_INVALID_GRAPH
 图形的句柄无效。
PEER_E_NOT_INITIALIZED
 必须先通过调用 PeerGraphStartup 初始化图形，然后才能使用此函数。

注解

世界时间 是派生自对等方系统时钟的 UTC 时间。

对等时间 是由对等图维护的常见参考时间，以格林威治标准时间表示。

每当需要在对等方计算机上显示此值时（例如显示记录的创建时间时），应将对等时间转换为通用时间。 同样，时间敏感操作（例如设置记录的过期时间或基于修改时间搜索记录）应使用时间值从特定于计算机的通用时间转换为特定于图形的对等时间。

可以通过调用相反函数 PeerGraphUniversalTimeToPeerTime 将通用时间转换为对等时间。

要求

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

另请参阅

PeerGraphUniversalTimeToPeerTime