Compartilhar via

Função PeerCollabSetObject (p2p.h)

  • Artigo

A função PeerCollabSetObject cria ou atualiza um objeto de dados par usado em uma rede de colaboração par.

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabSetObject(
  [in] PCPEER_OBJECT pcObject
);

Parâmetros

[in] pcObject

Ponteiro para uma estrutura PEER_OBJECT que contém o objeto par na rede de colaboração par.

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

Objetos pares são itens de dados em tempo de execução associados a um aplicativo específico, como uma imagem, um avatar, um certificado ou uma descrição específica. Cada objeto par deve ter um tamanho menor que 16K e não pode ser 0.

Se um objeto já estiver publicado, PeerCollabSetObject atualizará os dados de objeto existentes. O último aplicativo que atualiza o objeto assumirá a propriedade do objeto . Como resultado, se o aplicativo for encerrado, o objeto será excluído.

Se o status 'publicado' de um objeto for removido devido à saída em vez do fechamento do aplicativo associado, o aplicativo será responsável por publicar o objeto na próxima vez que o usuário fizer logon.

Os contatos confiáveis que observam esse objeto par terão um evento PEER_EVENT_OBJECT_CHANGED gerado localmente, sinalizando a alteração desse objeto par no status.

PeerCollabSetObject pode ser usado para publicar no máximo 128 objetos.

Há um objeto com um determinado GUID publicado a qualquer momento.

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_OBJECT

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