Compartilhar via

Função PeerGraphGetNodeInfo (p2p.h)

  • Artigo

A função PeerGraphGetNodeInfo recupera informações sobre um nó específico.

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphGetNodeInfo(
  [in]  HGRAPH          hGraph,
  [in]  ULONGLONG       ullNodeId,
  [out] PPEER_NODE_INFO *ppNodeInfo
);

Parâmetros

[in] hGraph

Identificador para um grafo par.

[in] ullNodeId

Especifica a ID de um nó sobre o qual um aplicativo recebe informações. Especifique zero (0) para recuperar informações sobre o nó local.

[out] ppNodeInfo

Recebe um ponteiro para uma estrutura PEER_NODE_INFO que contém as informações solicitadas. Quando o identificador não for necessário, libere-o chamando PeerGraphFreeData.

Retornar valor

Se a função for bem-sucedida, o valor retornado será S_OK. Caso contrário, a função retornará um dos seguintes códigos de erro.

Código de retorno Descrição
E_INVALIDARG
 Um parâmetro não é válido.
E_OUTOFMEMORY
 Não há memória suficiente para executar uma operação especificada.
PEER_E_INVALID_GRAPH
 O identificador para um grafo par é inválido.
PEER_E_NOT_INITIALIZED
 Um grafo par deve ser inicializado usando uma chamada para PeerGraphStartup antes de usar essa função.
PEER_E_NODE_NOT_FOUND
 Um nó especificado não foi encontrado.

Comentários

Pode haver vários nós de um grafo em um computador. Por exemplo, vários usuários podem ter ingressado no grafo em um computador específico, portanto, as informações retornadas por PeerGraphGetNodeInfo são sobre cada nó, não cada computador.

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

PEER_NODE_INFO

PeerGraphFreeData