Compartilhar via


Função PeerGraphSetPresence (p2p.h)

A função PeerGraphSetPresence ativa ou desativa explicitamente a publicação de registros de presença para um nó específico. Essa função pode substituir as configurações de presença nas propriedades do grafo par. Chamar essa função permite que nós sejam enumerados com PeerGraphEnumNodes.

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphSetPresence(
  [in] HGRAPH hGraph,
  [in] BOOL   fPresent
);

Parâmetros

[in] hGraph

Manipule para um grafo par.

[in] fPresent

Especifique TRUE para forçar a Infraestrutura de Grafo de Pares a publicar um registro de presença para esse nó, que substitui a configuração especificada pelo cPresenceMax em PEER_GRAPH_PROPERTIES. Especifique FALSE para retornar o nó ao comportamento padrão especificado nas propriedades do grafo par.

Nota Dependendo da política de presença de grafo par, definir fPresent como FALSE não garante que as informações de presença de um par sejam removidas. Isso significa que a presença de um par não é mais publicada.
 

Retornar valor

Se a chamada de função for bem-sucedida, o valor retornado será S_OK. Caso contrário, ele retornará um dos valores a seguir.

Código de retorno Descrição
E_INVALIDARG
Um dos parâmetros não é válido.
PEER_E_INVALID_GRAPH
O identificador para o grafo par é inválido. As informações de presença não podem ser publicadas.
PEER_E_NOT_INITIALIZED
O grafo par deve ser inicializado com uma chamada para PeerGraphStartup antes de usar essa função.

Comentários

Se as informações de presença não tiverem sido publicadas explicitamente pelo grafo par, os nós não ficarão visíveis quando um grafo par for enumerado.

Requisitos

Requisito Valor
Cliente mínimo com suporte Windows XP com SP2 [somente aplicativos da área de trabalho], Windows XP com SP1 com o Pacote de Rede Avançado paraWindows XP
Servidor mínimo com suporte Nenhum compatível
Plataforma de Destino Windows
Cabeçalho p2p.h
Biblioteca P2PGraph.lib
DLL P2PGraph.dll

Confira também

PeerGraphEnumNodes