Compartilhar via


Função PeerGraphUniversalTimeToPeerTime (p2p.h)

A função PeerGraphUniversalTimeToPeerTime converte um valor de tempo universal do computador do par em um valor comum de tempo de grafo par.

Sintaxe

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

Parâmetros

[in] hGraph

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

[in] pftUniversalTime

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

[out] pftPeerTime

Ponteiro para o valor utc (tempo de par 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 erros RPC ou 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 para o grafo par é 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 de par pode ser convertido em tempo universal chamando a função inversa PeerGraphPeerTimeToUniversalTime.

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

PeerGraphPeerTimeToUniversalTime