PeerGraphUniversalTimeToPeerTime 函式 (p2p.h)
PeerGraphUniversalTimeToPeerTime 函式會將通用時間值從對等的計算機轉換為一般對等圖形時間值。
語法
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphUniversalTimeToPeerTime(
[in] HGRAPH hGraph,
[in] FILETIME *pftUniversalTime,
[out] FILETIME *pftPeerTime
);
參數
[in] hGraph
這個對等參與的對等圖形句柄。 PeerGraphCreate 或 PeerGraphOpen 函式會傳回此句柄。
[in] pftUniversalTime
通用時間值的指標,以 FILETIME 結構表示。
[out] pftPeerTime
傳回的對等時間指標 (UTC) 值,以 FILETIME 結構表示。
傳回值
如果函式成功,則傳回S_OK;否則,函式會傳回其中一個 RPC 錯誤或下列其中一個值。
傳回碼 | Description |
---|---|
|
其中一個參數無效。 |
|
對等圖形的句柄無效。 |
|
使用這個函式之前,必須先使用 對PeerGraphStartup 的呼叫來初始化圖形。 |
備註
通用時間 是衍生自對等系統時鐘的 UTC 時間。
對等時間 是由對等圖形維護的常見參考時間,以 Greenwich Mean Time 表示。
每當需要在對等計算機上顯示此值時,對等時間應該轉換成通用時間,例如顯示記錄的建立時間時。 同樣地,時間敏感動作,例如設定記錄的到期時間,或根據修改時間搜尋記錄,應該使用從電腦特定通用時間轉換成對等圖形特定對等時間的時間值。
對等時間可以藉由呼叫對等函式 PeerGraphPeerTimeToUniversalTime來轉換成通用時間。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP 搭配 SP2 [僅限傳統型應用程式],Windows XP 搭配 SP1 與適用於Windows XP 的進階網络套件 |
最低支援的伺服器 | 都不支援 |
目標平台 | Windows |
標頭 | p2p.h |
程式庫 | P2PGraph.lib |
Dll | P2PGraph.dll |