共用方式為

PeerGroupPeerTimeToUniversalTime 函式 (p2p.h)

  • 發行項

PeerGroupPeerTimeToUniversalTime 函式會將對等群組維護的參考時間值轉換為適合在對等電腦上顯示的當地語系化時間值。

語法

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

參數

[in] hGroup

處理對等參與的對等群組。 這個句柄是由 PeerGroupCreate、PeerGroupOpen 或 PeerGroupJoin 函式傳回。 此為必要參數。

[in] pftPeerTime

以 FILETIME 結構表示的對等時間值指標-國際標準時間 (UTC) 。 此為必要參數。

[out] pftUniversalTime

傳回的通用時間值的指標，表示為 FILETIME 結構。 如果發生錯誤，此參數為 NULL 。

傳回值

如果函式成功，則傳回 S_OK 。 否則，函式會傳回其中一個遠端過程調用， (RPC) 錯誤或下列其中一個錯誤。

傳回碼 Description
E_INVALIDARG
 其中一個參數無效。
PEER_E_GROUP_NOT_READY
 對等群組不是可以正確擷取對等時間的狀態，例如，已呼叫 PeerGroupJoin ，但尚未完成與群組資料庫的同步處理。
PEER_E_NOT_INITIALIZED
 使用這個函式之前，必須先使用 對PeerGroupStartup 的呼叫來初始化對等群組。
 

密碼編譯特定錯誤可以從 Microsoft RSA 基底提供者傳回。 這些錯誤前面會加上 CRYPT_* 並在 Winerror.h 中定義。

備註

通用時間 是在對等計算機上維護的通用時間值。

對等時間 是由對等群組維護的常見參考時間，以UTC表示。 它通常與通用時間值位移，並用來修正延遲問題。

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

規格需求

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

另請參閱

PeerGroupUniversalTimeToPeerTime