PeerGraphUniversalTimeToPeerTime 函数 (p2p.h)

PeerGraphUniversalTimeToPeerTime 函数将通用时间值从对等的计算机转换为通用对等图时间值。

语法

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

参数

[in] hGraph

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

[in] pftUniversalTime

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

[out] pftPeerTime

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

返回值

如果函数成功,则返回S_OK;否则,函数将返回 RPC 错误之一或以下值之一。

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

注解

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

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

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

通过调用对等函数 PeerGraphPeerTimeToUniversalTime,可以将对等时间转换为通用时间。

要求

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

另请参阅

PeerGraphPeerTimeToUniversalTime