Funzione PeerGroupUniversalTimeToPeerTime (p2p.h)

Articolo
03/05/2024

La funzione PeerGroupUniversalTimeToPeerTime converte un valore di ora locale dal computer di un peer a un valore di ora del gruppo peer comune.

Sintassi

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

Parametri

[in] hGroup

Gestire il gruppo di peer a cui partecipa un peer. Questo handle viene restituito dalla funzione PeerGroupCreate, PeerGroupOpen o PeerGroupJoin . Questo parametro è obbligatorio.

[in] pftUniversalTime

Puntatore al valore di ora universale, rappresentato come struttura FILETIME . Questo parametro è obbligatorio.

[out] pftPeerTime

Puntatore al tempo peer restituito: valore di Greenwich Mean Time (GMT) rappresentato come struttura FILETIME . Questo parametro è NULL se si verifica un errore.

Valore restituito

Restituisce S_OK se la funzione ha esito positivo. In caso contrario, la funzione restituisce uno degli errori RPC o uno dei valori seguenti.

Codice restituito	Descrizione
E_INVALIDARG	Uno dei parametri non è valido.
PEER_E_GROUP_NOT_READY	Il gruppo di peer non è in uno stato in cui il tempo peer può essere calcolato in modo accurato. Ad esempio, PeerGroupJoin è stato chiamato, ma la sincronizzazione con il database del gruppo peer non è stata completata.
PEER_E_NOT_INITIALIZED	Il gruppo deve essere inizializzato con una chiamata a PeerGroupStartup prima di usare questa funzione.

Gli errori specifici della crittografia possono essere restituiti dal provider di base Microsoft RSA. Questi errori sono preceduti da CRYPT_* e definiti in Winerror.h.

Commenti

L'ora universale è il valore dell'ora universale mantenuto nel computer di un peer.

Il tempo peer è un tempo di riferimento comune gestito da un gruppo di peer, espresso come utc (Coordinated Universal Time). Viene spesso compensato dal valore di ora universale e viene usato per correggere i problemi di latenza.

L'ora peer può essere convertita in ora universale chiamando la funzione viceversa PeerGroupPeerTimeToUniversalTime.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP con SP2 [solo app desktop],Windows XP con SP1 con Advanced Networking Pack forWindows XP
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	p2p.h
Libreria	P2P.lib
DLL	P2P.dll

Vedi anche

PeerGroupPeerTimeToUniversalTime

Condividi tramite