Condividi tramite

Funzione PeerGroupUniversalTimeToPeerTime (p2p.h)

  • Articolo

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