Función PeerGraphGetNodeInfo (p2p.h)

La función PeerGraphGetNodeInfo recupera información sobre un nodo específico.

Sintaxis

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

Parámetros

[in] hGraph

Identificador de un gráfico del mismo nivel.

[in] ullNodeId

Especifica el identificador de un nodo sobre el que una aplicación recibe información. Especifique cero (0) para recuperar información sobre el nodo local.

[out] ppNodeInfo

Recibe un puntero a una estructura de PEER_NODE_INFO que contiene la información solicitada. Cuando no se necesite el identificador, desvíelo llamando a PeerGraphFreeData.

Valor devuelto

Si la función se realiza correctamente, el valor devuelto es S_OK. De lo contrario, la función devuelve uno de los siguientes códigos de error.

Código devuelto	Descripción
E_INVALIDARG	Un parámetro no es válido.
E_OUTOFMEMORY	No hay suficiente memoria para realizar una operación especificada.
PEER_E_INVALID_GRAPH	El identificador de un gráfico del mismo nivel no es válido.
PEER_E_NOT_INITIALIZED	Se debe inicializar un grafo del mismo nivel mediante una llamada a PeerGraphStartup antes de usar esta función.
PEER_E_NODE_NOT_FOUND	No se encuentra un nodo especificado.

Comentarios

Puede haber varios nodos de un grafo en un equipo. Por ejemplo, varios usuarios pueden haber unido el gráfico en un equipo específico, por lo que la información que peerGraphGetNodeInfo devuelve es sobre cada nodo, no sobre cada equipo.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP con SP2 [solo aplicaciones de escritorio],Windows XP con SP1 con advanced Networking Pack forWindows XP
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	p2p.h
Library	P2PGraph.lib
Archivo DLL	P2PGraph.dll

Consulte también

PEER_NODE_INFO

PeerGraphFreeData