Compartilhar via


Função PeerCollabDeleteObject (p2p.h)

A função PeerCollabDeleteObject exclui um objeto par do ponto de extremidade de chamada.

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabDeleteObject(
  [in] const GUID *pObjectId
);

Parâmetros

[in] pObjectId

Ponteiro para um valor GUID que identifica exclusivamente o objeto par a ser excluído do ponto de extremidade 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

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 3216K.

Os contatos confiáveis que observam esse objeto par e o assinante do contato "Eu" terão um evento PEER_EVENT_OBJECT_CHANGED gerado, sinalizando a alteração desse objeto par no status. PEER_EVENT_MY_OBJECT_CHANGED será gerado localmente.

Objetos predefinidos, como objetos Picture, não podem ser excluídos chamando essa API.

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