Função PeerCollabGetPresenceInfo (p2p.h)

A função PeerCollabGetPresenceInfo recupera as informações de presença do ponto de extremidade associado a um contato específico.

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabGetPresenceInfo(
  [in]  PCPEER_ENDPOINT     pcEndpoint,
  [out] PPEER_PRESENCE_INFO *ppPresenceInfo
);

Parâmetros

[in] pcEndpoint

Ponteiro para uma estrutura PEER_ENDPOINT que contém o ponto de extremidade específico associado ao contato especificado em pcContact para o qual as informações de presença devem ser retornadas.

[out] ppPresenceInfo

Ponteiro para o endereço da estrutura PEER_PRESENCE_INFO que contém os dados de presença solicitados para o ponto de extremidade fornecido.

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_OUTOFMEMORY	Não há memória suficiente para dar suporte a essa operação.
E_INVALIDARG	Um dos argumentos é inválido.
PEER_E_NOT_INITIALIZED	O aplicativo não fez uma chamada anterior para PeerCollabStartup.
PEER_E_NOT_FOUND	As informações de presença do ponto de extremidade especificado não foram encontradas na rede de colaboração par.

Comentários

Para obter um objeto par com êxito:

• O ponto de extremidade deve ter sido obtido anteriormente chamando PeerCollabEnumEndpoints.
• O par local deve ter se inscrito no ponto de extremidade chamando PeerCollabSubscribeEndpointData.
• Os dados do ponto de extremidade devem ser atualizados chamando PeerCollabRefreshEndpointData com êxito.

Requisitos

Requisito	Valor
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

Confira também

PEER_CONTACT

PEER_ENDPOINT

PEER_PRESENCE_INFO

Funções da API de Colaboração de Pares