Compartilhar via

Função PeerGroupPeerTimeToUniversalTime (p2p.h)

  • Artigo

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

Sintaxe

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

Parâmetros

[in] hGroup

Manipule para o grupo de pares no qual um par participa. Esse identificador é retornado pela função PeerGroupCreate, PeerGroupOpen ou PeerGroupJoin . Este parâmetro é necessário.

[in] pftPeerTime

Ponteiro para o valor de tempo de par — UTC (Tempo Universal Coordenado)— que é representado como uma estrutura FILETIME . Este parâmetro é necessário.

[out] pftUniversalTime

Ponteiro para o valor de tempo universal retornado representado como uma estrutura FILETIME . Esse parâmetro será NULL se ocorrer um erro.

Retornar valor

Retorna S_OK se a função for bem-sucedida. Caso contrário, a função retornará um dos erros de RPC (chamada de procedimento remoto) ou um dos erros a seguir.

Código de retorno Descrição
E_INVALIDARG
 Um dos parâmetros não é válido.
PEER_E_GROUP_NOT_READY
 O grupo de pares não está em um estado em que o tempo de par pode ser recuperado com precisão, por exemplo, PeerGroupJoin foi chamado, mas a sincronização com o banco de dados de grupo não foi concluída.
PEER_E_NOT_INITIALIZED
 O grupo de pares deve ser inicializado com uma chamada para PeerGroupStartup antes de usar essa função.
 

Erros específicos de criptografia podem ser retornados do Provedor Base do Microsoft RSA. Esses erros são prefixados com CRYPT_* e definidos em Winerror.h.

Comentários

Tempo universal é o valor de tempo universal mantido em um computador par.

Tempo de par é um tempo de referência comum mantido por um grupo de pares, expresso como UTC. Geralmente, ele é deslocado do valor de tempo universal e é usado para corrigir problemas de latência.

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

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 P2P.lib
DLL P2P.dll

Confira também

PeerGroupUniversalTimeToPeerTime