PeerGroupUniversalTimeToPeerTime 函式 (p2p.h)
PeerGroupUniversalTimeToPeerTime 函式會將本機時間值從對等的計算機轉換為一般對等群組時間值。
語法
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupUniversalTimeToPeerTime(
[in] HGROUP hGroup,
[in] FILETIME *pftUniversalTime,
[out] FILETIME *pftPeerTime
);
參數
[in] hGroup
對等參與的對等群組處理。 PeerGroupCreate、PeerGroupOpen 或 PeerGroupJoin 函式會傳回此句柄。 此為必要參數。
[in] pftUniversalTime
通用時間值的指標,以 FILETIME 結構表示。 此為必要參數。
[out] pftPeerTime
傳回對等時間的指標—Greenwich Mean Time (GMT) 值,以 FILETIME 結構表示。 如果發生錯誤,此參數為 NULL 。
傳回值
如果函式成功,則傳回 S_OK 。 否則,函式會傳回其中一個 RPC 錯誤或下列其中一個值。
傳回碼 | Description |
---|---|
|
其中一個參數無效。 |
|
對等群組不是可正確計算對等時間的狀態。 例如,已呼叫 PeerGroupJoin ,但尚未完成與對等群組資料庫的同步處理。 |
|
使用這個函式之前,必須先使用 對PeerGroupStartup 的呼叫來初始化群組。 |
密碼編譯特定錯誤可以從 Microsoft RSA 基底提供者傳回。 這些錯誤前面會加上 CRYPT_* ,並在 Winerror.h 中定義。
備註
通用時間 是對等計算機上維護的通用時間值。
對等時間 是由對等群組維護的常見參考時間,以國際標準時間表示 (UTC) 。 它通常是從通用時間值位移,並用來更正延遲問題。
對等時間可以藉由呼叫對等函式 PeerGroupPeerTimeToUniversalTime 來轉換成通用時間。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP 搭配 SP2 [僅限傳統型應用程式],Windows XP 搭配 SP1 與適用於Windows XP 的進階網络套件 |
最低支援的伺服器 | 都不支援 |
目標平台 | Windows |
標頭 | p2p.h |
程式庫 | P2P.lib |
Dll | P2P.dll |