Função PeerCollabSubscribeEndpointData (p2p.h)
A função PeerCollabSubscribeEndpointData cria uma assinatura para um ponto de extremidade disponível.
Sintaxe
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabSubscribeEndpointData(
[in] const PCPEER_ENDPOINT pcEndpoint
);
Parâmetros
[in] pcEndpoint
Ponteiro para uma estrutura PEER_ENDPOINT que contém o ponto de extremidade par usado para obter informações de presença.
Retornar valor
Retorna S_OK ou PEER_S_SUBSCRIPTION_EXISTS 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. |
|
A infraestrutura do Windows Peer não é inicializada. É necessário chamar a função de inicialização relevante. |
Comentários
PeerCollabSubscribeEndpointData é uma chamada assíncrona, o que significa que o processo para assinar o ponto de extremidade foi iniciado, mas não necessariamente concluído quando essa chamada retorna. Um aplicativo deve aguardar PEER_EVENT_REQUEST_STATUS_CHANGED obter o resultado da solicitação de assinatura.
Essa função terá um tempo limite de 30 segundos.
PeerCollabSubscribeEndpointData pode ser chamado várias vezes de aplicativos diferentes para o mesmo ponto de extremidade. Cada chamada é contada por referência; somente quando a última referência é lançada é um par não assinado. Para liberar a chamada de referência PeerCollabUnsubscribeEndpointData.
Quando um aplicativo é encerrado sem chamar PeerCollabUnsubscribeEndpointData, todas as referências para esse aplicativo são lançadas automaticamente.
Para chamar com êxito as APIs PeerCollabGetPresenceInfo, PeerCollabEnumApplications, PeerCollabEnumObjects e PeerCollabQueryContactData , um aplicativo deve primeiro chamar PeerCollabSubscribeEndpointData.
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 |