Compartilhar via

Função PeerGraphPeerTimeToUniversalTime (p2p.h)

  • Artigo

A função PeerGraphPeerTimeToUniversalTime converte o valor de tempo de referência mantido pelo grafo par em um valor de hora localizado apropriado para exibição no computador do par.

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphPeerTimeToUniversalTime(
  [in]  HGRAPH   hGraph,
  [in]  FILETIME *pftPeerTime,
  [out] FILETIME *pftUniversalTime
);

Parâmetros

[in] hGraph

Manipule para o grafo par do qual esse par participa. Esse identificador é retornado pela função PeerGraphCreate ou PeerGraphOpen .

[in] pftPeerTime

Ponteiro para o valor utc (tempo de par), representado como uma estrutura FILETIME .

[out] pftUniversalTime

Ponteiro para o valor de tempo universal retornado, representado como uma estrutura FILETIME .

Retornar valor

Retorna S_OK se a função for bem-sucedida; caso contrário, a função retornará um dos valores a seguir.

Código de retorno Descrição
E_INVALIDARG
 Um dos parâmetros não é válido.
PEER_E_INVALID_GRAPH
 O identificador do grafo é inválido.
PEER_E_NOT_INITIALIZED
 O grafo deve ser inicializado com uma chamada para PeerGraphStartup antes de usar essa função.

Comentários

Tempo universal é a hora UTC derivada do relógio do sistema do par.

Tempo de par é um tempo de referência comum mantido pelo grafo par, expresso como Hora média de Greenwich.

O tempo de par deve ser convertido em tempo universal sempre que for necessário exibir esse valor no computador do par, como ao exibir a hora de criação de um registro. Da mesma forma, ações sensíveis ao tempo, como definir o tempo de expiração de um registro ou pesquisar registros com base no tempo de modificação, devem usar valores de tempo convertidos do tempo universal específico do computador para o tempo de par específico do grafo.

O tempo universal pode ser convertido em tempo de par chamando a função inversa PeerGraphUniversalTimeToPeerTime.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP com SP2 [somente aplicativos da área de trabalho], Windows XP com SP1 com o Pacote de Rede Avançado paraWindows XP
Servidor mínimo com suporte Nenhum compatível
Plataforma de Destino Windows
Cabeçalho p2p.h
Biblioteca P2PGraph.lib
DLL P2PGraph.dll

Confira também

PeerGraphUniversalTimeToPeerTime