Compartir a través de

Función PeerGraphEnumNodes (p2p.h)

  • Artículo

La función PeerGraphEnumNodes crea y devuelve un identificador de enumeración usado para enumerar los nodos de un gráfico del mismo nivel. La enumeración proporciona una instantánea de un gráfico del mismo nivel en el momento en que se realiza una enumeración. Según la directiva de un gráfico del mismo nivel y, si los nodos no publican información de presencia, una enumeración no devuelve algunos nodos conectados a un gráfico del mismo nivel.

Sintaxis

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphEnumNodes(
  [in]  HGRAPH    hGraph,
  [in]  PCWSTR    pwzPeerId,
  [out] HPEERENUM *phPeerEnum
);

Parámetros

[in] hGraph

Identificador de un gráfico del mismo nivel.

[in] pwzPeerId

Identificador del mismo nivel para obtener una enumeración de nodo. Especifique NULL para devolver todos los nodos de un gráfico del mismo nivel.

[out] phPeerEnum

Recibe un identificador de una enumeración. Use PeerGraphGetNextItem para recuperar la información real del nodo. Cuando no se necesite este identificador, puede liberarlo llamando a PeerGraphEndEnumeration.

Valor devuelto

Si una llamada de función se realiza correctamente, el valor devuelto es S_OK. De lo contrario, devuelve uno de los valores siguientes.

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 con una llamada a PeerGraphStartup antes de usar esta función.
PEER_E_NOT_READY
 Un gráfico del mismo nivel no se sincroniza por completo y no se pueden enumerar los nodos.
PEER_E_PRESENCE_DISABLED
 Un gráfico del mismo nivel no requiere información de presencia. Por lo tanto, no se pueden enumerar los nodos.

Comentarios

Si se llama a PeerGraphGetNextItem con el identificador que devuelve PeerGraphEnumNodes , PeerGraphGetNextItem devuelve los datos de la estructura PEER_NODE_INFO .

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

PeerGraphEndEnumeration

PeerGraphGetItemCount

PeerGraphGetNextItem