共用方式為

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

以 FILETIME 結構表示的對等時間指標 (UTC) 值。

[out] pftUniversalTime

傳回之通用時間值的指標，表示為 FILETIME 結構。

傳回值

如果函式成功，則傳回S_OK;否則，函式會傳回下列其中一個值。

傳回碼 Description
E_INVALIDARG
 其中一個參數無效。
PEER_E_INVALID_GRAPH
 圖形的句柄無效。
PEER_E_NOT_INITIALIZED
 使用這個函式之前，必須先使用 對PeerGraphStartup 的呼叫來初始化圖形。

備註

通用時間 是衍生自對等系統時鐘的 UTC 時間。

對等時間 是由對等圖形維護的常見參考時間，以 Greenwich Mean Time 表示。

每當需要於對等計算機上顯示此值時，對等時間應該轉換成通用時間，例如顯示記錄的建立時間時。 同樣地，時間敏感動作，例如設定記錄的到期時間，或根據修改時間搜尋記錄，應該使用從電腦特定通用時間轉換為圖形特定對等時間的時間值。

通用時間可以藉由呼叫對等函式 PeerGraphUniversalTimeToPeerTime來轉換為對等時間。

規格需求

需求 值
最低支援的用戶端 Windows XP 搭配 SP2 [僅限傳統型應用程式]，Windows XP 含 SP1 與 Windows XP 的進階網络套件
最低支援的伺服器 都不支援
目標平台 Windows
標頭 p2p.h
程式庫 P2PGraph.lib
Dll P2PGraph.dll

另請參閱

PeerGraphUniversalTimeToPeerTime