Función PeerGroupPeerTimeToUniversalTime (p2p.h)

La función PeerGroupPeerTimeToUniversalTime convierte el valor de tiempo de referencia mantenido por el grupo del mismo nivel en un valor de hora localizado adecuado para mostrarse en un equipo del mismo nivel.

Sintaxis

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

Parámetros

[in] hGroup

Controle al grupo del mismo nivel en el que participa un elemento del mismo nivel. La función PeerGroupCreate, PeerGroupOpen o PeerGroupJoin devuelve este identificador. Este parámetro es obligatorio.

[in] pftPeerTime

Puntero al valor de hora del mismo nivel (Hora universal coordinada (UTC) que se representa como una estructura FILETIME . Este parámetro es obligatorio.

[out] pftUniversalTime

Puntero al valor de hora universal devuelto que se representa como una estructura FILETIME . Este parámetro es NULL si se produce un error.

Valor devuelto

Devuelve S_OK si la función se realiza correctamente. De lo contrario, la función devuelve uno de los errores de llamada a procedimiento remoto (RPC) o uno de los errores siguientes.

Código devuelto	Descripción
E_INVALIDARG	Uno de los parámetros no es válido.
PEER_E_GROUP_NOT_READY	El grupo del mismo nivel no está en un estado en el que se puede recuperar con precisión el tiempo del mismo nivel, por ejemplo, se ha llamado a PeerGroupJoin , pero no se ha completado la sincronización con la base de datos de grupo.
PEER_E_NOT_INITIALIZED	El grupo del mismo nivel debe inicializarse con una llamada a PeerGroupStartup antes de usar esta función.

 

Los errores específicos de criptografía se pueden devolver desde el proveedor base RSA de Microsoft. Estos errores tienen el prefijo CRYPT_* y se definen en Winerror.h.

Comentarios

La hora universal es el valor de hora universal mantenido en un equipo del mismo nivel.

La hora del mismo nivel es una hora de referencia común mantenida por un grupo del mismo nivel, expresada como UTC. A menudo se desplaza desde el valor de hora universal y se usa para corregir problemas de latencia.

La hora universal se puede convertir en hora del mismo nivel llamando a la función inversa PeerGroupUniversalTimeToPeerTime.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP con SP2 [solo aplicaciones de escritorio],Windows XP con SP1 con advanced Networking Pack forWindows XP
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	p2p.h
Library	P2P.lib
Archivo DLL	P2P.dll

Consulte también

PeerGroupUniversalTimeToPeerTime