Compartilhar via


Função PeerCollabSetPresenceInfo (p2p.h)

A função PeerCollabSetPresenceInfo atualiza as informações de presença do chamador para todos os contatos que o observam.

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabSetPresenceInfo(
  [in] PCPEER_PRESENCE_INFO pcPresenceInfo
);

Parâmetros

[in] pcPresenceInfo

Ponteiro para uma estrutura PEER_PRESENCE_INFO que contém as novas informações de presença a serem publicadas para o aplicativo par de chamada.

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
A infraestrutura do Windows Peer não é inicializada. É necessário chamar a função de inicialização relevante.
PEER_E_NOT_SIGNED_IN
A operação exige que o usuário entre.

Comentários

Os contatos que observam a presença desse par terão um evento PEER_EVENT_PRESENCE_CHANGED gerado localmente que sinaliza a mudança de presença desse par status. A presença de um par status não pode ser definida como offline durante a entrada. Por padrão, a presença de um par status é 'online' e o texto descritivo é NULL ao entrar.

Qualquer texto descritivo para status de presença é limitado a 255 caracteres Unicode.

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

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