Compartilhar via


Função PeerGroupUniversalTimeToPeerTime (p2p.h)

A função PeerGroupUniversalTimeToPeerTime converte um valor de hora local do computador de um par em um valor comum de hora do grupo de pares.

Sintaxe

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

Parâmetros

[in] hGroup

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

[in] pftUniversalTime

Ponteiro para o valor de tempo universal, representado como uma estrutura FILETIME . Este parâmetro é necessário.

[out] pftPeerTime

Ponteiro para o tempo de par retornado – o valor gmt (Hora média de Greenwich) 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 ou um dos valores 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 calculado com precisão. Por exemplo, PeerGroupJoin foi chamado, mas a sincronização com o banco de dados de grupo par não foi concluída.
PEER_E_NOT_INITIALIZED
O grupo 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 no computador de um par.

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

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

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

PeerGroupPeerTimeToUniversalTime