Compartir a través de

Función PeerGroupUniversalTimeToPeerTime (p2p.h)

  • Artículo

La función PeerGroupUniversalTimeToPeerTime convierte un valor de hora local del equipo del mismo nivel en un valor de hora común del grupo del mismo nivel.

Sintaxis

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

Parámetros

[in] hGroup

Identificador del 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] pftUniversalTime

Puntero al valor de hora universal, representado como una estructura FILETIME . Este parámetro es obligatorio.

[out] pftPeerTime

Puntero a la hora del mismo nivel devuelta: valor de hora media de Greenwich (GMT) 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 rpc o uno de los valores 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 el tiempo del mismo nivel se puede calcular con precisión. Por ejemplo, se ha llamado a PeerGroupJoin , pero no se ha completado la sincronización con la base de datos del grupo del mismo nivel.
PEER_E_NOT_INITIALIZED
 El grupo 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 el equipo del mismo nivel.

El tiempo del mismo nivel es un tiempo de referencia común mantenido por un grupo del mismo nivel, expresado como hora universal coordinada (UTC). A menudo se desplaza del valor de hora universal y se usa para corregir los problemas de latencia.

El tiempo del mismo nivel se puede convertir en hora universal llamando a la función converse PeerGroupPeerTimeToUniversalTime.

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

PeerGroupPeerTimeToUniversalTime