Função PeerCollabRefreshEndpointData (p2p.h)
A função PeerCollabRefreshEndpointData atualiza o nó par de chamada com novos dados de ponto de extremidade.
Sintaxe
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabRefreshEndpointData(
[in] PCPEER_ENDPOINT pcEndpoint
);
Parâmetros
[in] pcEndpoint
Ponteiro para uma estrutura de PEER_ENDPOINT que contém as informações atualizadas do ponto de extremidade par para o nó par atual.
Valor retornado
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 |
|---|---|
|
Não há memória suficiente para dar suporte a essa operação. |
|
Um dos argumentos é inválido. |
Comentários
PeerCollabRefreshEndpointData permite que um aplicativo atualize os dados associados ao ponto de extremidade. Após a conclusão da API, o evento PEER_EVENT_REQUEST_STATUS_CHANGED será gerado. O evento conterá um código de êxito ou falha.
Com êxito, o aplicativo pode chamar funções como PeerCollabGetPresenceInfo, PeerCollabEnumApplications, PeerCollabEnumObjects e PeerCollabQueryContactData para obter dados adicionais. Quando os dados não forem mais necessários, eles poderão ser excluídos chamando PeerCollabDeleteEndpointData.
Se um par for inscrito no ponto de extremidade, os dados inscritos terão precedência maior do que os dados armazenados em cache chamando PeerCollabRefreshEndpointDataand retornarão PEER_EVENT_REQUEST_STATUS_CHANGED.
A API PeerCollabRefreshEndpointData usa uma instantâneo dos dados para o ponto de extremidade especificado. Se os dados do ponto de extremidade forem alterados após essa instantâneo, o chamador terá uma cópia obsoleta dos dados. Se PeerCollabRefreshEndpointData for chamado por um aplicativo várias vezes para o mesmo ponto de extremidade, os dados mais recentes recebidos substituirão os dados armazenados de uma chamada anterior à API. No entanto, para garantir que o chamador seja notificado sobre quaisquer alterações e sempre tenha a cópia mais recente, PeerCollabSubscribeEndpointData é recomendado em vez de PeerCollabRefreshEndpointData.
A função PeerCollabRefreshEndpointData atingirá o tempo limite em 30 segundos.
Requisitos
| Cliente mínimo com suporte | Windows Vista [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Nenhum compatível |
| Plataforma de Destino | Windows |
| Cabeçalho | p2p.h |
| Biblioteca | P2P.lib |
| DLL | P2P.dll |